Skip to main content
GET
/
v1
/
manage
/
apikey
/
{id}
/
usage
Get API key usage
curl --request GET \
  --url https://api-v2.requesty.ai/v1/manage/apikey/{id}/usage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "start": "2025-01-01T00:00:00Z",
  "end": "2025-01-31T23:59:59Z",
  "group_by": [
    "<string>"
  ],
  "resolution": "day"
}'
{
  "usage": {}
}
Get usage statistics for a specific API key within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.

Authorizations

​
Authorization
string
header
required

API key for authentication

Path Parameters

​
id
string<uuid>
required

Body

application/json
​
start
string<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.

Example:

"2025-01-01T00:00:00Z"

​
end
string<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.

Example:

"2025-01-31T23:59:59Z"

​
group_by
string[]

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

​
resolution
enum<string>
default:day

Time resolution for aggregation

Available options:
hour,
day,
month

Response

200 - application/json

Successfully retrieved usage data

​
usage
object
required

Map of period (string) to usage entry