---
title: "Read a prepaid x402 credit balance"
method: GET
path: "/v1/credits"
---

# Read a prepaid x402 credit balance

`GET /v1/credits`

## Request

- Base URL: `https://api.recallsapi.com`
- URL: `https://api.recallsapi.com/v1/credits`
- Auth: API key in header `X-Credit-Token`

Free and unmetered. Balance, spend, calls charged, prices and the last 20 top-ups of the token in X-Credit-Token.

## Response `200`

OK

- object
  - `balance_usd` string
  - `balance_micro_usd` integer
  - `funded_usd` string
  - `spent_usd` string
  - `calls` integer
  - `prices_usd` object
  - `topup_amounts_usd` string[]
  - `topups` object[]
    - `transaction` string
    - `amount_usd` string
    - `network` string
    - `at` string, date-time

## Other responses

- `401`: Missing or unknown credit token

---

[API](https://skmtc.dev/recallsapi/apis/recallsapi-com.md) · [All operations](https://skmtc.dev/recallsapi/apis/recallsapi-com/llms.txt) · [OpenAPI document](https://skmtc.dev/recallsapi/apis/recallsapi-com/revisions/2501df40ea54?raw)