APIReferenceRuns
List a category's runs
Paginated, newest-first enumeration of a category's visible completed runs.
GET
/api/categories/{category_id}/runs/AuthorizationBearer <token>
Personal Access Token (create one from Settings -> API Keys in the dashboard). Send as Authorization: Bearer gr_live_.... An X-API-Key: gr_live_... header (see the apiKeyAuth scheme) is accepted as an equivalent alternative — send ONE of the two, not both.
In: header
Path Parameters
category_id*integer
Query Parameters
page?integer
1-based page number.
page_size?integer
Rows per page. Server-side default/cap vary per endpoint.
Response Body
application/json
curl -X GET "https://example.com/api/categories/0/runs/"{ "results": [ { "id": "string", "timestamp": "string", "score": 0, "status": "string", "categoryId": "string" } ], "count": 0, "next": "string", "previous": "string"}List a brand's runs GET
Paginated, newest-first enumeration of a brand's visible completed runs.
Get what changed for a prompt vs its last run GET
Deterministic diff of this prompt's latest scored run against its predecessor: model-mention flips, rank shift, competitor appear/disappear, sentiment shift.