---
title: "Check prepaid credit balance"
method: GET
path: "/v5/credits/balance"
tags: ["Billing"]
---

# Check prepaid credit balance

`GET /v5/credits/balance`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/credits/balance`
- Auth: API key in header `X-Oracle-Key`

Returns the credit balance the authenticated key actually spends, and reading it spends none. For a credit-pack key (tier credits) it is the pack balance, consumed 1-per-call. For a free key it is the prepaid credits from /v5/credits/purchase, consumed 1-per-request on /v5/status and /v5/batch when the free tier limit is reached.

## Response `200`

Credit balance

- object
  - `balance` integer: Remaining prepaid credits.
  - `estimated_requests_remaining` integer
  - `last_purchased` string, date-time

## Other responses

- `401`: Missing API key
- `403`: Invalid API key
- `503`: SERVICE_UNAVAILABLE: the credit-pack balance could not be read. The key was not rejected; retry after the Retry-After header.

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)