List runs

Returns run history across all boosts, newest first.

GET /v1/runs

Requires scope: runs:read

Query parameters

Parameter	Type	Required	Description
`boost_id`	integer	Optional	Filter by boost ID.
`limit`	integer	Optional	Number of results per page. Default: `20`, max: `100`.
`offset`	integer	Optional	Pagination offset. Default: `0`.

Example request

curl "https://api.cache-boost.com/v1/runs?boost_id=15&limit=20" \
  -H "Authorization: Bearer cb_live_YOUR_KEY"

Response

Returns 200 OK with a paginated list of run objects.

{
  "data": [
    {
      "id": 88,
      "boost_id": 15,
      "status": "done",
      "status_message": null,
      "started_at": "2025-01-15T01:00:05Z",
      "finished_at": "2025-01-15T01:04:22Z",
      "summary": {
        "total_calls": 1240,
        "successful_calls": 1238,
        "failed_calls": 2,
        "cache_hits": 1165,
        "average_response_time_ms": 112.5,
        "pops": {"CDG": 620, "AMS": 618}
      },
      "created_at": "2025-01-15T01:00:00Z"
    }
  ],
  "limit": 20,
  "offset": 0
}

Status values

Value	Description
`pending`	Run is queued and waiting to start.
`running`	Run is currently in progress.
`done`	Run completed successfully.
`failed`	Run ended with errors.
`paused`	Run was paused due to high error rate.

Errors

Code	Description
`401`	Missing or invalid API key.
`403`	Insufficient scope.