Skip to main content
GET
Get API key usage

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

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.

Response

AI spending for one API key: totals, daily usage, and model and deployment breakdowns. serving names the catalog host and sovereignty tier when recorded; null means no deployment was recorded, not where inference ran. Read from the AI usage ledger; usd is the customer charge at the credit rate and never provider cost.

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.

api_key
object
required
timeframe
object
required
summary
object
required
series
object[]
required
models
object[]
required
serving
object[]
required

The same spend cut by the deployment that served it. Ordered by spend descending, then by request count descending, then by host, then by tier; the row whose host and tier are both null is always last, because it is the absence of a record rather than a deployment. Additive: it neither replaces nor re-slices any other field.