Get provider costs and outstanding reservations

GET/v1/inference-usage

Authorization

Authorizationstringrequired

Bearer tak_… — an application API key. Keep it on your backend; all resources are scoped to that application.

Create an application key →

Query parameters

application_idstring

Optional with an application key, which always pins the scope. A different application returns 403.

Min length: 1

Response

200Get provider costs and outstanding reservations

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

spent_nanostringrequired

reserved_nanostringrequired

budget_usdstringrequired

attemptsarray<object>required

Additional keys: any

4XX400 invalid input; 401 missing/revoked credentials; 403 disallowed operation/application; 404 missing or inaccessible resource; 409 conflicting submission/version/state; 413 body too large; 415 unsupported content type. Inspect error.code, not message text.

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired

Object fields

codestringrequired

messagestringrequired

request_idstringrequired

Additional keys: any

5XX500 unexpected failure or 503 unavailable dependency. A failed response does not prove that a submission was not committed. Retry job/flow admission with the same key and body.

X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired

Object fields

codestringrequired

messagestringrequired

request_idstringrequired

Additional keys: any