Skip to main content

List jobs, newest first

GET /v1/jobs

List jobs, newest first

Credential. An API key (jean_live_…) or a dashboard session token.

curl --fail-with-body "https://api-833252724876.us-central1.run.app/v1/jobs" \
-H "Authorization: Bearer $JEAN_API_KEY"

Query

NameTypeRequiredNotes
type"eval", "predict" or nullno
status"queued", "running", "succeeded", "failed", "cancelled" or nullno
limitintegernoRange: 1–200. Default 50.
beforestring or nullnoReturn jobs created before this time.

Response · 200

{
"jobs": [
{
"attempts": 1,
"created_at": "2026-01-15T09:30:00Z",
"finished_at": "2026-01-15T09:30:18Z",
"id": "job_q1w2e3r4t5y6u7i8o9p0",
"label": "nightly",
"org_id": "org_k3j2h4g5f6d7s8a9q0w1",
"request_id": "req_z9x8c7v6b5n4m3l2",
"result": {
"hfm_sha": "9f2c1ab4d7e0",
"metric": "accuracy",
"n": 200,
"n_submitted": 200,
"n_unmatched": 0,
"suite_id": "suite:smoke-v1",
"suite_version": "1",
"value": 0.734
},
"started_at": "2026-01-15T09:30:02Z",
"status": "succeeded",
"trace_url": "https://storage.googleapis.com/jean-artifacts/.../trace.json",
"type": "eval",
"versions": {
"hfm_sha": "9f2c1ab4d7e0",
"suite_id": "suite:smoke-v1",
"suite_version": "1"
}
}
]
}

Errors

StatusMeaning
401Unauthenticated, invalid token or revoked key.
403Forbidden, session required or org required.
422Validation failed.
429Quota or rate limit exceeded; error.details says which, and when.
500Internal error; quote error.request_id when reporting it.

Every one carries the same envelope.

API overview · Full contract