Skip to main content
GET
/
usage
/
stats
Get organization usage stats
curl --request GET \
  --url https://app.usechar.ai/api/usage/stats \
  --header 'Authorization: Bearer <token>'
{
  "total_requests": 123,
  "total_prompt_tokens": 123,
  "total_completion_tokens": 123,
  "total_tokens": 123
}

Authorizations

​
Authorization
string
header
required

WorkOS JWT token. Obtain via WorkOS AuthKit authentication flow. The token must include organization_id claim for organization-scoped endpoints.

Query Parameters

​
start_date
string<date-time>

Start date for the query range (ISO 8601 format)

​
end_date
string<date-time>

End date for the query range (ISO 8601 format)

Response

OK

Aggregated token usage statistics

​
total_requests
number
required

Total number of chat requests

​
total_prompt_tokens
number
required

Total prompt (input) tokens used

​
total_completion_tokens
number
required

Total completion (output) tokens used

​
total_tokens
number
required

Total tokens used (prompt + completion)