---
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' | 'insights' | 'records'
    - `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-25** `2077d5ecc87d` — 3 warning, 4 info
  - added the new `campaign` enum value to the `usage/items/kind` response property for the response status `200`
  - added the new `insights` enum value to the `usage/items/kind` response property for the response status `200`
  - added the new `records` enum value to the `usage/items/kind` response property for the response status `200`
  - removed the `campaign_brief` enum value from the `usage/items/kind` response property for the response status `200`
  - …3 more
- **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
- …earlier changes not shown

[Full 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.dev/kinetk/apis/kinetk-graph-service-api/revisions/2077d5ecc87d?raw)