v2

latestOpenAPI 3.0.32026-07-26112274.7 KB

List your async jobs

Returns async jobs as a paginated list, sorted and filtered by the query parameters. Heavy fields (payload, artifact manifest) are omitted — fetch full per-job state via GET /api/v1/forecasts/{id}.

Jobs tombstoned by the retention policy are excluded here and return 404 on the detail endpoint.

get/api/v1/jobs

Query parameters

pageinteger

1-indexed page number.

limitinteger

Page size. Capped at 200.

sort'id' | 'created_at' | 'settled_at' | 'eur_cents_final'

Column to sort by.

order'asc' | 'desc'

Sort direction.

status'queued' | 'running' | 'completed' | 'failed' | 'canceled'

Filter to jobs in this status.

pipeline_typestring

Filter to jobs of this pipeline type (currently only forecast is emitted).

Response

Paginated job list.

Example response

{
  "jobs": [
    {
      "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "pipeline_type": "forecast",
      "status": "completed",
      "created_at": "2026-05-01T10:00:00Z",
      "settled": true,
      "settled_at": "2026-05-01T10:04:32Z",
      "eur_cents_final": 250
    }
  ]
}