Skip to main content
GET
List API key usage

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Query Parameters

preset
enum<string>
default:30d

Relative timeframe preset, counted in whole days of the requested timezone.

Available options:
7d,
30d,
90d
timezone
string
default:UTC

IANA time zone for daily bucket boundaries, such as Europe/Berlin. Numeric UTC offsets are not accepted.

project_reference
string

Optional project UUID or slug. Scopes the listing to that project’s keys.

Response

AI spending by API key; kind separates individual keys from grouped usage, including requests without API key authentication. With project_reference: the project’s keys, requests without a key, and usage from deleted key records. Without it: the caller’s own keys and requests without a key; usage of a deleted key record cannot be recovered. Read from the AI usage ledger; usd is the customer charge at the credit rate and never provider cost.

timeframe
object
required
attribution
object
required

Whether attribution is complete for the returned usage. Treat it as incomplete if enabled is false, recording_since is null, or the selected period includes an unattributed row.

summary
object
required

Sum of the rows below.

keys
object[]
required