Account

Query usage audit history

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.

get/auth/usage/history/v2

Request

  • Base URL: https://qveris.ai/api/v1
  • URL: https://qveris.ai/api/v1/auth/usage/history/v2
  • Auth: OAuth 2 (password, token URL /api/v1/auth/login)

Query parameters

start_datestring nullable

开始日期 (YYYY-MM-DD)

end_datestring nullable

结束日期 (YYYY-MM-DD)

event_typestring nullable

事件类型过滤

kindstring nullable

事件分组过滤

successboolean nullable

是否成功

billable_successboolean nullable

是否可计费

outcomestring nullable

执行 outcome 过滤

reason_codestring nullable

执行 reason_code 过滤

has_execution_outcomeboolean nullable

是否存在 execution_outcome

charge_outcomestring nullable

收费结果过滤

anomalystring nullable

异常类型过滤

search_idstring nullable

search_id 聚焦过滤

execution_idstring nullable

execution_id 聚焦过滤

api_key_idstring uuid nullable

API Key 归因过滤

oauth_client_idstring nullable

OAuth client_id 归因过滤

credential_typestring nullable

凭证类型过滤

pageinteger

页码

page_sizeinteger

每页数量

include_detailsboolean

是否在列表中返回完整审计详情字段

min_creditsnumber nullable
max_creditsnumber nullable
bucketstring nullable
summaryboolean
limitinteger nullable

Response

Successful Response

statusstring required
messagestring required
status_codeinteger
message_keystring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.