List usage

GEThttps://api.inferencebureau.com/v1/usage

Your team's requests, newest first, with tokens and settled cost. Page through any period with the cursor, as JSON or CSV. Any key of the team reads the whole team's usage; narrow it with the filters.

Query

limitintegeroptional
Rows per page, 1 to 1000. Defaults to 50.
cursorstringoptional
The next_cursor of the page before. Pages run backwards in time, so a cursor stays valid while new requests arrive. Keep the same filters from page to page.
from, toISO 8601optional
Requests created at or after from and before to, such as 2026-10-01 or 2026-10-01T00:00:00Z.
project, environment, keystringoptional
Only requests of that project, environment or API key, by id.
modelstringoptional
Only requests answered by this model (or asking for it, when none answered).
endpointstringoptional
chat.completions, messages, responses, embeddings, evaluate or suggest.
sessionstringoptional
Only requests of one session (ib-session), such as an Auditor review.
end_userstringoptional
Only requests for one of your end users, exactly as sent (ib-user or user).
tagstringoptional
Only requests carrying this tag, exactly. Combine with end_user for one user's spend on one feature.
billing_statestringoptional
One of reserved, awaiting_usage, settled, released, disputed (usage under review) or adjusted.
formatjson | csvoptional
csv (or Accept: text/csv) returns the page as CSV with a header row, one column per field (usage and cost flattened, tags comma-separated in one cell); the next cursor is in the X-Next-Cursor response header, absent on the last page.

Response

data[].modelstringrequired
The model that answered, or the one requested if none did.
data[].created_at, completed_atstringrequired
ISO 8601 in UTC. completed_at is null while the request runs.
data[].transport_state, billing_state, error_codestringrequired
As on the receipt; error_code is null for a success.
data[].end_user, tagsstring | null, string[]required
Who the request was for and its tags, as sent; null and [] when none were.
data[].usageobject | nullrequired
Tokens across the request's attempts; null until usage is known.
data[].costobject | nullrequired
Decimal strings in USD: what the request cost upstream, the platform fee, and the charge to your balance. null until the request settles. data[].customer_charge repeats the charge for older clients.
has_morebooleanrequired
Whether older rows match.
next_cursorstring | nullrequired
Pass as cursor for the next page; null on the last one.