---
title: "Get Usage Credits Spent"
method: GET
path: "/auth/usage/credits-spent"
tags: ["Account"]
---

# Get Usage Credits Spent

`GET /auth/usage/credits-spent`

## Request

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

Return the total credits spent by the current user in the given date range.

Uses a single server-side SUM query — no pagination limit — so results are
accurate even for high-volume users with thousands of events in the window.

## Query parameters

- `start_date` string, nullable: 开始日期 (YYYY-MM-DD)
- `end_date` string, nullable: 结束日期 (YYYY-MM-DD)
- `kind` string, nullable: 事件分组过滤
- `charge_outcome` string, nullable: 收费结果过滤

## Response `200`

Successful Response

- APIResponseUsageCreditsSpentResponse
  - `status` string, required
  - `message` string, required
  - `status_code` integer
  - `data` UsageCreditsSpentResponse
    - `total_credits` number, required
    - `start_date` string, nullable
    - `end_date` string, nullable
  - `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)