Get goal conversions
Read the Goals report of the dashboard for a date range.
GET https://cotlet.dev/api/v1/plausible/goal-conversions
read
Returns the goals report: the visitors who converted, the number of conversions and the conversion rate for each goal. Plausible shows a goal in the dashboard only after its first conversion is recorded, so a goal with no data in the range is missing from this report; compare it with list_goals to find them.
Parameters
| Name | Type | Description |
|---|---|---|
| site string required | string | Domain of the site as the Sites page lists it, e.g. acme-shop.example. |
| from string | string | First day of the date range, YYYY-MM-DD. Default: the last 30 days. |
| to string | string | Last day of the date range, YYYY-MM-DD. Default: today. |
| goal string | string | Display name of one goal. Leave out for all goals. |
Request
curl "https://cotlet.dev/api/v1/plausible/goal-conversions?site=site" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("plausible", "get_goal_conversions", {"site":"site"})const result = await cotlet.call('plausible', 'get_goal_conversions', {"site":"site"});cotlet call plausible get_goal_conversions --data '{"site":"site"}'Example response
{
"site": "acme-shop.example",
"from": "2026-10-12",
"to": "2026-10-18",
"goals": [
{
"goal": "Checkout complete",
"visitors": 212,
"conversions": 218,
"conversion_rate": "5.0%"
},
{
"goal": "Newsletter signup",
"visitors": 164,
"conversions": 164,
"conversion_rate": "3.9%"
}
]
}