v1

latestOpenAPI 3.0.32026-07-132681171.6 KB

Get API key usage

Get usage statistics for a specific API key within a date range

get/v1/manage/apikey/{id}/usage

Path parameters

idstring uuid required

Request body

startstring date-time required

Start date in RFC3339 format (e.g., 2025-01-01T00:00:00Z). Required. The date range cannot exceed 100 days from start to end.

endstring date-time

End date in RFC3339 format (e.g., 2025-01-31T23:59:59Z). Optional. Defaults to 24 hours from start if not specified. Must be after start date. The date range cannot exceed 100 days.

group_bystring[]

Fields to group by: user_id, model_requested, or extra.<field_name>

resolution'hour' | 'day' | 'month'

Time resolution for aggregation

Example request

{
  "start": "2025-01-01T00:00:00Z",
  "end": "2025-01-31T23:59:59Z"
}

Response

Successfully retrieved usage data

usageobject required

Map of period (string) to usage entry