GET
agents/{public_id}/runs/
Service tier
Read one of the runs by id. derived from route
URL
- Service tierhttps://agents.mattering.io/api/internal/v1/agents/{public_id}/runs/
Path parameters
| Name | Type |
|---|---|
public_id | str |
Pagination
Accepts limit and offset. The response meta carries total, limit and offset.
Responses
200 data and meta envelope
{
"data": [
{
"id": "...",
"trigger": "...",
"status": "...",
"started_at": "2026-01-01T00:00:00Z",
"finished_at": "2026-01-01T00:00:00Z",
"error_message": "...",
"tokens_in": "...",
"cache_read_tokens": "...",
"cache_create_tokens": "...",
"tokens_out": "...",
"cost_cents": 0.0,
"conversation_id": "...",
"schedule_id": "..."
}
],
"meta": {
"total": 0,
"limit": 0,
"offset": 0,
"has_more": true
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 404 | agent_not_found |
Example
curl -X GET "https://agents.mattering.io/api/internal/v1/agents/PUBLIC_ID/runs/" \ -H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \ -H "X-Internal-Org-Id: $ORG_ID" \ -H "X-Internal-User-Email: you@example.com"
Source: MatterCore/agents_api.py (agents_api.agent_runs)