Get agent analytics

Per-agent usage stats, conversation counts, tool calls, and credit consumption over a time window.

GET /api/v1/analytics/agents/:agent_id

Returns per-agent usage statistics, conversation counts, tool calls, credits consumed, over a configurable time window.

Scope: analytics:read

Path parameters

Param	Type	Notes
`:agent_id`	string	Agent ID (prefixed or bare).

Query parameters

Param	Type	Default	Notes
`since`	ISO 8601	30 days ago	Window start.
`until`	ISO 8601	now	Window end.
`cursor`	string		For paginated row lists inside the response.
`limit`	integer	`25`	Range 1–100.

Example request

curl 'https://dashboard.getmacha.com/api/v1/analytics/agents/agent_64f1c0...?since=2026-06-01T00:00:00Z' \
  -H "Authorization: Bearer $MACHA_API_KEY"

Response shape

The exact data shape is in flux as the per-agent analytics tab matures. The contract today is that data is a free-form analytics object, treat the keys defensively.

⚠

Beta shape

This endpoint's response keys will stabilize when the analytics dashboard UI ships. Until then, expect the response shape to gain fields and treat unknown keys leniently.

Errors

Status	Code	When
`404`	`agent_not_found`	Unknown agent ID.
`422`	`validation_failed`	Bad date range, malformed cursor.