---
title: "Get Usage History V2 Summary"
method: GET
path: "/auth/usage/history/v2/summary"
tags: ["Account"]
---

# Get Usage History V2 Summary

`GET /auth/usage/history/v2/summary`

## Request

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

获取轻量 usage events summary，用于账号页列表快速渲染。

## Query parameters

- `start_date` string, nullable: 开始日期 (YYYY-MM-DD)
- `end_date` string, nullable: 结束日期 (YYYY-MM-DD)
- `event_type` string, nullable: 事件类型过滤
- `kind` string, nullable: 事件分组过滤
- `success` boolean, nullable: 是否成功
- `billable_success` boolean, nullable: 是否可计费
- `outcome` string, nullable: 执行 outcome 过滤
- `reason_code` string, nullable: 执行 reason_code 过滤
- `has_execution_outcome` boolean, nullable: 是否存在 execution_outcome
- `charge_outcome` string, nullable: 收费结果过滤
- `anomaly` string, nullable: 异常类型过滤
- `search_id` string, nullable: search_id 聚焦过滤
- `execution_id` string, nullable: execution_id 聚焦过滤
- `api_key_id` string, uuid, nullable: API Key 归因过滤
- `oauth_client_id` string, nullable: OAuth client_id 归因过滤
- `credential_type` string, nullable: 凭证类型过滤
- `cursor` string, nullable: 下一页游标
- `page_size` integer: 每页数量

## Response `200`

Successful Response

- APIResponseUsageEventSummaryResponse
  - `status` string, required
  - `message` string, required
  - `status_code` integer
  - `data` UsageEventSummaryResponse
    - `items` UsageEventSummaryItem[], required
      - `anomalies` string[], nullable
      - `id` string, required
      - `event_type` string, required
      - `source_system` string, required
      - `source_ref_type` string, nullable
      - `source_ref_id` string, nullable
      - `credential_type` string, nullable
      - `api_key` UsageEventApiKey
        - `id` string, required
        - `name` string, required
        - `masked_value` string, required
      - `api_key_attribution_status` string
      - `oauth_client` UsageEventOAuthClient
        - `id` string, required
      - `credential_attribution_status` 'api_key' | 'oauth_client' | 'user_session' | 'non_api_key' | 'historical_unknown'
      - `session_id` string, nullable
      - `search_id` string, nullable
      - `execution_id` string, nullable
      - `tool_id` string, nullable
      - `model` string, nullable
      - `query` string, nullable
      - `success` boolean, required
      - `charge_outcome` string, required
      - `error_message` string, nullable
      - `duration_ms` number, nullable
      - `transport_success` boolean, nullable
      - `provider_success` boolean, nullable
      - `result_valid` boolean, nullable
      - `billable_success` boolean, nullable
      - `outcome` string, nullable
      - `outcome_status` string, nullable
      - `reason_code` string, nullable
      - `outcome_message` string, nullable
      - `provider_status_code` string, nullable
      - `provider_status_message` string, nullable
      - `http_status_code` integer, nullable
      - `valid_result_count` integer, nullable
      - `raw_result_count` integer, nullable
      - `chargeable_quantity` number, nullable
      - `retryable` boolean, nullable
      - `display_severity` string, nullable
      - `billing_snapshot_status` string, nullable
      - `requested_amount_credits` number, nullable
      - `actual_amount_credits` number, nullable
      - `credits_ledger_entry_id` string, nullable
      - `charge_event_id` string, nullable
      - `settlement_state` string, nullable
      - `settlement_batch_id` string, nullable
      - `settlement_ledger_entry_id` string, nullable
      - `display_target` string, nullable
      - `billing_unit` string, nullable
      - `unit_price_credits` number, nullable
      - `quantity` number, nullable
      - `list_amount_credits` number, nullable
      - `minimum_charge_credits` number, nullable
      - `pricing_profile_id` string, nullable
      - `billing_summary` string, nullable
      - `pre_settlement_amount_credits` number, nullable
      - `settled_amount_credits` number, nullable
      - `pricing_context_id` string, nullable
      - `harbor_snapshot_id` string, nullable
      - `harbor_snapshot_version` string, nullable
      - `resolver_version` string, nullable
      - `details_available` boolean
      - `created_at` string, date-time, required
    - `next_cursor` string, nullable
    - `has_more` boolean, required
    - `page_size` integer, required
  - `message_key` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/qveris/apis/qveris-public-rest-api.md) · [All operations](https://skmtc.dev/qveris/apis/qveris-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qveris/apis/qveris-public-rest-api/revisions/7b78aeef092a?raw)