Skip to main content

Usage this period

GET /v1/usage

Usage this period

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

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

Response · 200

{
"org_id": "org_k3j2h4g5f6d7s8a9q0w1",
"plan": "free",
"period_start": "2026-01-15T09:30:00Z",
"period_end": "2026-01-15T09:30:00Z",
"totals": {
"eval_items": 18000,
"requests": 412
},
"active_jobs": 1,
"limits": {
"concurrent_jobs": 2,
"eval_items_per_month": 20000
}
}

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