GET /api/v1/jobs
Lists the caller’s async jobs. Payload and artifact manifest are omitted — use GET /api/v1/forecasts/:id for full job state (forecast pipelines today).
| Attribute | Details |
|---|---|
| Auth | Required |
| Rate limits | May return 429 when polling too fast (per-user bucket). |
Query parameters
| Param | Default | Notes |
|---|---|---|
page | 1 | |
limit | 50 | 1–200. |
sort | created_at | id, created_at, settled_at, eur_cents_final. |
order | desc | asc / desc. |
status | (none) | Optional: queued, running, completed, failed, canceled. |
pipeline_type | (none) | Optional filter; today only forecast is emitted. |
Visibility
When a post-settlement visibility window is in effect, older jobs are filtered out here as well as on the forecast detail endpoint — you should not see a row that GET /api/v1/forecasts/:id would answer with 404.
Response
JSON object with jobs (lightweight summaries: job_id UUID, pipeline_type, status, created_at, settled, optional settled_at, eur_cents_final, terminal_reason) and pagination. Monetary fields are returned as integer EUR cents.