---
title: "Get Credit History"
method: GET
path: "/v1/credits/history"
tags: ["credits"]
---

# Get Credit History

`GET /v1/credits/history`

## Request

- Base URL: `https://api.theagentc.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.theagentc.io/v1/credits/history`
- Auth: HTTP bearer

Get paginated credit ledger history.

Returns past credit transactions with newest first.
Useful for auditing and understanding usage patterns.

## Query parameters

- `limit` integer: Items per page
- `offset` integer: Pagination offset

## Response `200`

Successful Response

- CreditHistory: Paginated credit ledger history.
  - `items` CreditDeduction[], required: Ledger entries for this page
    - `id` string, required: Ledger entry ID
    - `amount` integer, required: Credits deducted (absolute value, positive number)
    - `reason` string, required: Reason for deduction
    - `description` string, nullable: Additional context
    - `balance_after` integer, required: Balance after this deduction
    - `created_at` string, date-time, required: When this transaction occurred
  - `total_count` integer, required: Total ledger entries across all pages
  - `has_more` boolean, required: Whether there are more pages

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/theagentc/apis/the-agent-c-api.md) · [All operations](https://skmtc.dev/theagentc/apis/the-agent-c-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theagentc/apis/the-agent-c-api/revisions/1c9868b44584?raw)