---
title: "Get credit history"
method: GET
path: "/v1/credits/history"
tags: ["Credits"]
---

# Get credit history

`GET /v1/credits/history`

## Request

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

Returns credit transaction history (purchases, consumption, adjustments, bonuses), most recent first, with page/limit pagination.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Paginated credit history.

- object
  - `items` object[], required
    - `id` string, uuid
    - `customer_id` string, uuid
    - `user_id` string, uuid, nullable
    - `amount` integer: Credit amount. Positive = credit, negative = debit.
    - `type` string: Transaction type: purchase, consumption, adjustment, bonus.
    - `description` string, nullable
    - `operation_type` string, nullable: Pipeline stage that consumed credits, if applicable.
    - `metadata` object
    - `created_at` string, date-time
  - `total` integer, required: Total number of transactions.
  - `page` integer, required
  - `limit` integer, required

## Other responses

- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

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