---
title: "Get user balance (guide credits + AI tokens)"
method: GET
path: "/api/v1/credits"
tags: ["v1", "Usage"]
---

# Get user balance (guide credits + AI tokens)

`GET /api/v1/credits`

## Request

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

Returns the authenticated user's full balance.

SERPmantics has TWO distinct currencies:

- **credits** (`credits`): how many NEW GUIDES the user can still create.
  Consumed once per guide creation. `"unlimited"` if the user's plan
  grants unlimited guide creation (`hasUnlimitedCredits: true`).

- **AI tokens** (`tokens`): pool consumed by every AI feature (meta,
  outline, intent, internal-links, EEAT, EEAT competitors…).
  Each feature has its own cost — call `/api/v1/tokens-usage` to get
  the per-feature pricing.

Do not confuse the two: running out of `credits` blocks new guides;
running out of `tokens` blocks AI features inside existing guides.

## Response `200`

Successful response with user balance

- object
  - `success` boolean
  - `credits` union: Remaining guide-creation credits, or "unlimited"
    - number
    - 'unlimited'
  - `hasUnlimitedCredits` boolean: True if the user's plan grants unlimited guide creation
  - `tokens` number: Remaining AI tokens (used by meta, outline, intent, internal-links, EEAT)

## Other responses

- `401`: Unauthorized
- `500`: Server error

---

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