---
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` '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

---

[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/380fcc6f794a/schema)