Authentication
Use an API key (mana_api_...) in the Authorization header:
- The key works on its own project only. A key of another project gets
404. - The key needs the scope of the endpoint. Without it, the response is
403FORBIDDEN, and the message names the scope. - Call the API from a server. A request with a browser
Originheader gets403. - The key shares its rate limits with the MCP server: 120 requests per minute per key, and 600 per minute per workspace.
Endpoints
Every path starts with
/v0/projects/{projectId}.
Filters
The report endpoints take the same filters:date_fromanddate_toasYYYY-MM-DD(UTC). The default is the last 30 days. A range is at most 367 days.- Context filters, for example
utm_source,channel_type,country,deviceandpage_path. filters: operator filters as{ "field", "op", "value" }objects, combined with AND. On aGETendpoint, send them as a JSON array in the query string. On aPOSTendpoint, send them as an array in the body.
Responses
A report returns the resource with no envelope:date_fromanddate_toare the range of the report, also when you leave them out.rowsare the report rows.totals(event timeseries only) has the totals for the range.noteshas fixed sentences on how to read the session columns, when a filter changes them.
400 INVALID_QUERY, and the message names the parameter.