Skip to main content
GET
/
v1
/
manage
/
org
/
usage
Get organization usage
curl --request GET \
  --url https://api-v2.requesty.ai/v1/manage/org/usage \
  --header 'Authorization: Bearer <token>'
{
  "usage": {}
}
Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, member, API key, model, or custom fields.

Authorizations

​
Authorization
string
header
required

API key for authentication

Query Parameters

​
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"

​
resolution
enum<string>
default:day

Time resolution for aggregation

Available options:
hour,
day,
month
​
group_by
string[]

Fields to group by: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, or extra.<field_name>. Can be specified multiple times.

Response

Successfully retrieved usage data

​
usage
object
required

Map of period (string) to usage entry

Last modified on June 18, 2026