URL: /docs/credits

---
title: "Credits: how paid deep checks are priced"
description: What a credit is, what each section of a deep check costs, what each plan includes, how top-ups are priced, and how to read your balance from the API or MCP.
sidebarTitle: Credits
icon: coins
---

**Credits** pay for paid deep checks of any domain you type. They are separate from [reveals](/docs/concepts#reveal): a reveal discloses a masked name in the directory, a credit buys a report. Reading your balance, your history and your past checks is always free.

At the base rate, **1 credit is $0.01**. Every price and grant on this page is read from Revised's own configuration, and `GET /api/v1/credits` reports the live numbers, so read them there rather than hard-coding this page.

## What a deep check costs

A deep check covers one domain, in up to four sections. Each is priced separately and charged only when it completes. A section that fails is refunded in full.

| Section | Credits |
| --- | --- |
| `overview` | 30 |
| `referring_domains` | 40 |
| `backlinks` | 40 |
| `anchors` | 30 |
| All four | 140 |

Sections run in priority order: overview, referring domains, backlinks, anchors. A saved check of the same name from the last 7 days is returned for 0 credits, and sections you already paid for in that window are not charged again.

The check reads only the name you send, never the directory, so the report is the same whether or not the name is listed. See [Checks on any domain](/docs/guides/checks-on-any-domain#deep-check).

## Price first, then spend

A request without `confirm: true` spends nothing. It answers `confirmation_required` with the price, whether your balance covers it, and a `topup_url`. Only a request with `confirm: true` and an `Idempotency-Key` runs the check and spends credits. A retry with the same key never charges twice.

If your balance covers only some sections, those run and the response reports a `clamp`. If it covers none, the answer is `402 insufficient_credits` with `required`, `balance` and `topup_url`.

While a check runs, the credits it needs are held in a pending reservation, so `available` can be lower than `balance`. A reservation is released after 15 minutes if it is not used.

## What each plan includes

| Plan | Credits |
| --- | --- |
| Free | 150, once, on signup |
| Starter | 1,000 a month |
| Business | 10,000 a month |

Monthly credits expire at the end of the period. Credits from a top-up never expire. Free signup credits are for new accounts only and are subject to abuse checks.

## Top-ups

A top-up is a single payment of whole dollars from $10 to $2,000. The more you pay in one payment, the more credits each dollar buys. The tier is chosen by the size of that one payment, not by your running total.

| Single payment of at least | Credits per dollar |
| --- | --- |
| $10 | 100 |
| $100 | 110 |
| $250 | 125 |
| $500 | 140 |
| $1,000 | 160 |
| $2,000 | 175 |

`POST /api/v1/credits/topup` returns a checkout `url` for a person to open and pay; no card passes through the API, and an agent cannot top up. Credits arrive when the payment is confirmed. A top-up call creates a checkout session each time, so it is limited to 5 a minute per account.

Refunded monthly credits that have no live period to return to expire after 7 days. They are never turned into permanent credit.

## Read your balance

`GET /api/v1/credits` and the MCP `get_credit_balance` tool report:

| Field | Meaning |
| --- | --- |
| `balance` | Monthly plus pack credits. |
| `available` | `balance` less credits held by checks still running. |
| `monthly` | Included with your plan. Expires at `monthly_resets_at`. |
| `pack` | Top-up credits. They never expire. |
| `pending` | Credits reserved by running checks. |
| `check_cost` | What a full check costs. |
| `topup` | The top-up range (`min_usd`, `max_usd`) and the price `tiers`. |

`GET /api/v1/credits/ledger` and `list_credit_transactions` list your history, newest first: grants, top-ups, debits for checks, refunds and expiries, each with a signed amount.

<CardGroup cols={2}>
  <Card title="Checks on any domain" icon="search-check" href="/docs/guides/checks-on-any-domain">
    Value estimate, spam history and deep check, by REST and MCP.
  </Card>
  <Card title="MCP tools" icon="wrench" href="/docs/mcp/tools#get_credit_balance">
    The credit and check tools, with arguments and refusals.
  </Card>
</CardGroup>
