APIReference

Get organization usage

GET
/v1/codius/usage

Returns the five-hour session, weekly, and billing-cycle usage windows for the calling organization. Requires the usage:read scope.

AuthorizationBearer <token>

A Codius organization API key, sent as Authorization: Bearer codius_live_…. Keys carry a subset of the models:read, inference:create, and usage:read scopes — never billing or admin permissions.

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/codius/usage"
{  "object": "codius.usage",  "session": {    "usage_percent": 42,    "reset_at": "2026-07-23T15:00:00.000Z"  },  "week": {    "usage_percent": 17,    "reset_at": "2026-07-27T00:00:00.000Z"  },  "month": {    "usage_percent": 8,    "reset_at": "2026-08-01T00:00:00.000Z"  }}