> ## Documentation Index
> Fetch the complete documentation index at: https://docs.outbound.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing and billing

> What each call costs, how a paid call is charged, and where to see it.

Calls draw on your organization's prepaid balance, in US dollars. New accounts get \$1 of free calls on their first organization; after that, top up from \$10 in the console, or turn on auto-recharge to top up from a saved card when the balance runs low.

## Prices

| Call | Price |
| - | - |
| [Search people](https://docs.outbound.dev/api-reference/people/search-people.md) | \$0.0001 per person returned |
| [Search companies](https://docs.outbound.dev/api-reference/companies/search-companies.md) | \$0.0001 per company returned |
| [List a company's people](https://docs.outbound.dev/api-reference/companies/list-a-companys-people.md) | \$0.0001 per person returned |
| [Run a saved search](https://docs.outbound.dev/api-reference/saved-searches/run-a-saved-search.md) | \$0.0001 per person returned |
| Everything else: counts, filter values, suggestions, naming a company, saved searches, your account | Free |

`GET /v1/prices` answers the price list in force, with its version. A call pays the prices in force when it started.

## How a paid call is charged

**1. The most it can cost is held**

Before a search runs, `limit` times the price is set aside from your balance: 25 people hold \$0.0025. If your available balance cannot cover it, the call answers `402` with `insufficient_balance`, and nothing runs. If it would take the key past its daily cap, it answers `402` with `key_daily_cap_reached`.

**2. It is charged for what it returned**

When the page comes back, the call is charged for the records on it, and the rest of the hold is released. A page of 7 people costs \$0.0007.

**3. A miss or a failure costs nothing**

A page with nobody on it costs nothing. A call that is refused (any `4xx`) or fails on our side (`5xx`) is never charged, and its hold is released.

## See what a call cost

Every answer carries two headers:

| Header | What it holds |
| - | - |
| `X-Charged-Usd` | What this call cost, such as `0.000700`. `0.000000` for a free call. |
| `X-Balance-Usd` | The balance after this call. |

The same charge shows up in three places:

* `GET /v1/requests` and `GET /v1/requests/{requestId}`: every call of the last 30 days, with its cost.
* `GET /v1/usage`: calls and spend by UTC day, by product and by route.
* `GET /v1/wallet/transactions`: the ledger, every change to the balance with the balance after it. It needs a key with full access.

`GET /v1/wallet` answers the balance, what is held for calls in progress, and what new calls can use. See [Track your spend](https://docs.outbound.dev/guides/track-spend.md).

## Money in answers

Amounts are US dollars as exact six-decimal strings, such as `"9.999500"`, never floats. In the ledger, money in is positive and a charge is negative.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.