GET /auth/usage/history/v2
Query canonical usage events to confirm request success, failure, and final charge outcome. Agent, CLI, and MCP clients should prefer precise filters such as execution_id or summary=true with a bounded limit instead of dumping full history.
REST API overview · OpenAPI JSON · OpenAPI YAML
| Stability | Authentication | Cost | Operation ID |
|---|---|---|---|
| Published | Bearer API key | Free | get_usage_history_v2_api_v1_auth_usage_history_v2_get |
| Name | Location | Required | Type | Description |
|---|---|---|---|---|
start_date | query | No | string | null | — |
end_date | query | No | string | null | — |
event_type | query | No | string | null | — |
kind | query | No | string | null | — |
success | query | No | boolean | null | — |
billable_success | query | No | boolean | null | — |
outcome | query | No | string | null | — |
reason_code | query | No | string | null | — |
has_execution_outcome | query | No | boolean | null | — |
charge_outcome | query | No | string | null | — |
anomaly | query | No | string | null | — |
search_id | query | No | string | null | — |
execution_id | query | No | string | null | — |
api_key_id | query | No | string | null | — |
page | query | No | integer | — |
page_size | query | No | integer | — |
include_details | query | No | boolean | — |
min_credits | query | No | number | null | — |
max_credits | query | No | number | null | — |
bucket | query | No | string | null | — |
summary | query | No | boolean | — |
limit | query | No | integer | null | — |
This operation has no JSON request body.
curl --request GET \
--url "https://qveris.ai/api/v1/auth/usage/history/v2" \
--header "Authorization: Bearer $QVERIS_API_KEY"
const response = await fetch("https://qveris.ai/api/v1/auth/usage/history/v2", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.QVERIS_API_KEY}`,
},
})
if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
console.log(await response.json())
import os
import requests
response = requests.request(
"GET",
"https://qveris.ai/api/v1/auth/usage/history/v2",
headers={"Authorization": f"Bearer {os.environ['QVERIS_API_KEY']}"},
timeout=30,
)
response.raise_for_status()
print(response.json())
| Status | Meaning | Schema |
|---|---|---|
200 | Successful Response | APIResponse_UsageEventsResponse_ |
400 | Invalid audit query | APIResponse_dict_ |
422 | Validation Error | HTTPValidationError |
{
"status": "success",
"message": "Usage events retrieved successfully",
"status_code": 0,
"data": {
"items": [
{
"id": "evt_01HZX9R31GH2R",
"event_type": "tool_execute",
"source_system": "qveris_website",
"source_ref_type": "execute_history",
"source_ref_id": "2b7f7c4a-9f3a-4f61-8b59-3a983a8192a0",
"session_id": "sess_7Q9m",
"search_id": "srch_01HZX9QK7J3M9T",
"execution_id": "exec_01HZX9R2R4S2E",
"tool_id": "openweathermap.weather.execute.v1",
"success": true,
"charge_outcome": "charged",
"duration_ms": 211,
"billing_snapshot_status": "upstream_provided",
"pre_settlement_amount_credits": 5,
"settled_amount_credits": 5,
"actual_amount_credits": 5,
"credits_ledger_entry_id": "led_01HZX9R39K6QZ",
"display_target": "openweathermap.weather.execute.v1",
"billing_summary": "5 credits per successful request",
"created_at": "2026-05-16T08:30:12Z"
}
],
"total": 1,
"page": 1,
"page_size": 50,
"summary": null
}
}
POST Discover capabilities · POST Inspect capabilities · POST Probe a capability · POST Call a capability
Was this page helpful?