---
title: "Get credit balance, unit prices, and packs"
method: GET
path: "/v1/credits"
tags: ["Billing"]
---

# Get credit balance, unit prices, and packs

`GET /v1/credits`

## Request

- Base URL: `https://serp-agent.com`
- URL: `https://serp-agent.com/v1/credits`
- Auth: HTTP bearer

Prepaid credit balance (1 credit = $1 list price) plus the unit price list and purchasable packs. Credits pay for individual work units on live keys when a project has NO subscription (subscribed projects are all-inclusive; sandbox keys use the free trial budget). Larger packs carry bonus credits (volume discount). `available: false` on a pack means the operator has not configured its product yet (purchase would 503).

## Response `200`

Balance + catalog.

- CreditsOverview
  - `balance_credits` integer, required: Whole credits available (1 credit = $1 = 100 cents of User balance).
  - `currency` 'USD', required
  - `credit_usd_value` 1, required
  - `unit_prices` object, required: Price in credits per work unit.
  - `packs` object[], required
    - `id` 'pack_500' | 'pack_2000' | 'pack_10000', required
    - `usd` number, required
    - `credits` integer, required
    - `bonus_credits` integer, required: Free credits on top of the dollar price (volume discount).
    - `available` boolean, required: False while the operator has not configured the pack's Creem product (purchase would 503).
  - `purchase` 'POST /v1/credits/purchases', required
  - `notes` string[]

## Other responses

- `401`: Missing, malformed, unknown, revoked, or expired API key. Codes: `unauthorized`, `key_revoked`, `key_expired`.
- `429`: Rate limit exceeded (600 requests/minute per API key). Honor `Retry-After`.

---

[API](https://skmtc.dev/serp-agent/apis/serp-agent-api.md) · [All operations](https://skmtc.dev/serp-agent/apis/serp-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/serp-agent/apis/serp-agent-api/revisions/438a943019ac?raw)