---
title: "List credit transactions"
method: GET
path: "/v1/account/credits/history"
tags: ["Account"]
---

# List credit transactions

`GET /v1/account/credits/history`

## Request

- Base URL: `https://nanostudiopro.com/api`
- URL: `https://nanostudiopro.com/api/v1/account/credits/history`
- Auth: HTTP bearer

Paginated transaction log for the user's wallet — every charge, refund, refill, or trial-credit bump. Each row carries the running balance after the transaction so you can render a spend timeline without recomputing.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Transactions, newest first.

- object
  - `items` object[]
    - `id` string
    - `type` string: `charge` | `refund` | `refill` | `trial` | etc.
    - `amount` integer: Negative for charges, positive for credits added.
    - `balance_after` integer
    - `description` string, nullable
    - `reference_id` string, nullable: Related entity id (a Generation, an Asset, etc.) when applicable.
    - `token_id` string, nullable: Set when the spend was triggered by an API token. Useful for attributing usage per integration.
    - `created_at` string, date-time
  - `total` integer
  - `limit` integer
  - `offset` integer

## Other responses

- `401`: Missing or invalid token
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api.md) · [All operations](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/revisions/b454211e598e?raw)