---
title: "Get Usage History V2 Entry"
method: GET
path: "/auth/usage/history/v2/{event_id}"
tags: ["Account"]
---

# Get Usage History V2 Entry

`GET /auth/usage/history/v2/{event_id}`

## Request

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

获取单条 usage event 详情。

## Path parameters

- `event_id` string, uuid, required

## Response `200`

Successful Response

- APIResponseUsageEventItem
  - `status` string, required
  - `message` string, required
  - `status_code` integer
  - `data` UsageEventItem
    - `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
    - `request_payload` object, nullable
    - `response_payload_summary` object, nullable
    - `execution_outcome` object, nullable
    - `outcome_schema_version` string, 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
    - `billing_rule_snapshot` object, nullable
    - `pre_settlement_bill` object, nullable
    - `settlement_result` object, 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
    - `created_at` string, date-time, 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)