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

API key usage statistics

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.