Usage History
View your API usage logs with token counts and costs.
GET
/v1/usage
Get usage history
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| limit | integer | 50 | Number of records (max 200) |
Response
json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"data": [
{
"id": "log_abc123",
"user_id": "usr_xyz",
"model": "gpt-4o-mini",
"provider_id": "openai",
"tokens_used": "docs-token-number">142,
"latency_ms": "docs-token-number">823,
"status": "success",
"credits_charged": "docs-token-number">1,
"call_type": "chat",
"created_at": "2026-03-29T14:30:00Z"
}
]
}