---
title: "Get usage history"
method: GET
path: "/api/usage-history"
tags: ["Account"]
---

# Get usage history

`GET /api/usage-history`

## Request

- Base URL: `https://api.xpoz.ai`
- URL: `https://api.xpoz.ai/api/usage-history`
- Auth: HTTP bearer

Credits and export rows used per time bucket.

## Query parameters

- `range` 'today' | '7d' | 'current_month' | 'lifetime'
- `granularity` 'hour' | 'day'

## Response `200`

Usage history.

- UsageHistory
  - `range` 'today' | '7d' | 'current_month' | 'lifetime', required
  - `granularity` 'hour' | 'day', required
  - `generatedAt` string, date-time, required
  - `credits` UsageBucket[], required
    - `bucket` string, required
    - `subscriptionUsed` number, required
    - `extraUsed` number, required
    - `totalUsed` number, required
    - `extraPurchased` number, required
  - `exportRows` UsageBucket[], required
    - `bucket` string, required
    - `subscriptionUsed` number, required
    - `extraUsed` number, required
    - `totalUsed` number, required
    - `extraPurchased` number, required

## Other responses

- `400`: Query or body validation failed. `message` joins all validation issues with `, `.
- `401`: Missing or invalid credentials.
- `500`: Server error.

---

[API](https://skmtc.dev/xpoz/apis/xpoz-api.md) · [All operations](https://skmtc.dev/xpoz/apis/xpoz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xpoz/apis/xpoz-api/revisions/c18261f587a4?raw)