---
title: "Credit usage history for your account"
method: GET
path: "/usage"
---

# Credit usage history for your account

`GET /usage`

Newest-first ledger entries (top-ups, settlements, refunds) for the account the key belongs to. Paginate with `limit` + `cursor`; scope to a single key with `keyId`.

## Response `200`

Successful response

- IUsageResponse
  - `accountId` string, required
  - `keyId` string
  - `nextCursor` string
  - `usage` IUsageEntry[], required
    - `balanceAfter` number
    - `credits` number, required
    - `jobId` string
    - `keyId` string
    - `kind` 'campaign_brief' | 'intelligence_records' | 'intelligence_signals' | 'llm_context'
    - `occurredAt` string, required
    - `reason` string
    - `stripeDisputeId` string
    - `stripePaymentIntentId` string
    - `stripeRefundId` string
    - `txnId` string, required
    - `type` 'refund' | 'reserve' | 'reversal' | 'settle' | 'topup', required
    - `window` string

## Other responses

- `default` — Error response

## Changes

- **2026-06-10** `eaecae836740` — 4 info
  - added the optional property `keyId` to the response with the `200` status
  - added the optional property `nextCursor` to the response with the `200` status
  - added the required property `accountId` to the response with the `200` status
  - added the required property `usage` to the response with the `200` status
- **2026-06-10** `f85c9ce4ec2e` — 2 breaking, 5 warning, 2 info
  - removed the required property `accountId` from the response with the `200` status
  - removed the required property `usage` from the response with the `200` status
  - deleted the `query` request parameter `cursor`
  - deleted the `query` request parameter `keyId`
  - …5 more
- **2026-06-10** `127a0031f70f` — 2 warning, 4 info
  - added the new `intelligence_records` enum value to the `usage/items/kind` response property for the response status `200`
  - added the new `intelligence_signals` enum value to the `usage/items/kind` response property for the response status `200`
  - the `window` response's property default value `all` was removed for the status `200`
  - removed the `24h` enum value from the `usage/items/window` response property for the response status `200`
  - …2 more
- **2026-06-05** `afaed57dbb10` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api/changes/usage/get.md)

---

[API](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api.md) · [All operations](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kinetk/kinetk-graph-service-api/revisions/eaecae836740/schema)