---
title: "Read account balance events including the reason for each bonus grant"
method: GET
path: "/v1/capacity/history"
---

# Read account balance events including the reason for each bonus grant

`GET /v1/capacity/history`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/capacity/history`
- Auth: API key in header `Authorization`

## Response `200`

Read account balance events including the reason for each bonus grant

- object
  - `data` CapacityHistoryData, required
    - `events` CapacityHistoryEventData[], required
      - `event_key` string, required
      - `kind` string, required
      - `payload` object, required
      - `created_at` string, date-time, required

## Other responses

- `default`: Error envelope

---

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