# Scalelist API pricing: email, mobile and people search costs

Most Scalelist API calls are charged only when a result comes back: an email from the B2B Email Finder at $29 per 500 requests, a mobile number at $0.58, $0.058 for each search profile and $0.058 for each email a company lookup returns. A People Count costs $0.058 per call whatever it finds, and the Industry Lookup is free. Every paid service draws on Prepaid lead data credit, bought by card from $1.

## At a glance

- **Base URL:** `https://agents.scalelist.com/zcj/iri0xmr7pmjj`. Every endpoint below is a `POST` with a JSON body.
- **Charged only on a result:** B2B Email Finder and Mobile Number Finder. A `"Not found"` email or a `"not_found"` number is free. Domain Email Finder and People Search charge per email or profile returned.
- **Charged per call:** People Count, once per call, whatever the size of the audience.
- **Free:** Industry Lookup, for registered agents. In the catalog, no meter includes free units.
- **Payment:** card only, with no wallet needed. Prepaid lead data covers every paid service. Pay as you go covers the B2B Email Finder only.
- **Credential:** `Authorization: Bearer <token>` on every call. A call without it gets `401 bearer_required` before any price is quoted.
- **Live prices:** [manifest.json](https://agents.scalelist.com/zcj/iri0xmr7pmjj/manifest.json). Read it at call time.
- **Full purchase flow:** [the buyer skill](https://agents.scalelist.com/zcj/iri0xmr7pmjj/SKILL.md)

## Price per service

| Service | Endpoint | Charged for | Price | Plans |
| --- | --- | --- | --- | --- |
| B2B Email Finder | `/agent/email/find` | Each lookup that returns an email. `"Not found"` is free. | Pay as you go: $29 per 500 requests. Prepaid lead data: $29 per 500 requests | Pay as you go, Prepaid lead data |
| Domain Email Finder | `/agent/email/domain` | Each email returned, up to `limit` | $0.058 | Prepaid lead data |
| Mobile Number Finder | `/agent/phone/find` | Each number found. `"not_found"` is free. | $0.58 | Prepaid lead data |
| People Search | `/agent/people/search` | Each profile returned, up to `page_size` | $0.058 | Prepaid lead data |
| People Count | `/agent/people/count` | Each call | $0.058 | Prepaid lead data |
| Industry Lookup | `/agent/people/industries` | Nothing | Free for registered agents | None needed |

Two request fields cap what a call can cost. On the Domain Email Finder, `limit` sets the most emails returned (default 10, max 100). On People Search, `page_size` sets the most profiles on a page (max 100), and you are billed for exactly the profiles returned. The Domain Email Finder's `total` field tells you how many emails are known at the company, and only the returned ones are charged.

## Worked costs

| Job | Calls | Most you pay |
| --- | --- | --- |
| Work emails for 100 named people | 100 B2B Email Finder lookups on Prepaid lead data | $5.80 |
| Size an audience, then fetch one page of 100 profiles | 1 People Count, 1 People Search with `page_size` 100 | $5.858 |
| Mobile numbers for 20 people | 20 Mobile Number Finder lookups | $11.60 |

The totals assume every email and mobile lookup finds a result and the search returns a full page of 100 profiles. An email or mobile lookup that comes back not found is free, and a page with fewer profiles costs less, so the real cost can be lower. The People Count is charged whatever it finds.

## Plans and how they are paid

| Plan | Covers | How calls are paid | Minimum |
| --- | --- | --- | --- |
| Pay as you go | B2B Email Finder only | One priced 402 per call, paid by card. The card rail takes a single call of $0.50 or more. | Nothing to buy |
| Prepaid lead data | Every paid service | Calls draw down a prepaid credit balance | $1 per purchase, $1 by card |

On Pay as you go there is nothing to buy first: each call returns its own 402, and an attempt to purchase the plan returns `payg_not_purchasable`.

Prepaid lead data's `purchase.url` is in [manifest.json](https://agents.scalelist.com/zcj/iri0xmr7pmjj/manifest.json), and [the buyer skill](https://agents.scalelist.com/zcj/iri0xmr7pmjj/SKILL.md) has the purchase and top-up flow. Unused funds stay as credit, and remaining credit is not refunded automatically.

Prepaid lead data asks for a verified email. A purchase shares the verified email of the person who claimed your credential with Scalelist, so Scalelist can tie the purchase to their account. That happens at purchase when the credential is already claimed, or later when it is claimed. Claim the credential before or soon after buying: an anonymous credential that nobody claims lapses within a few days, and so does credit bought with it. The claim steps are in [agent identity](https://agents.scalelist.com/zcj/iri0xmr7pmjj/auth.md).

## What a people count draws from credit

Send the count with your bearer and at least one filter:

```bash
curl -sS -i -X POST https://agents.scalelist.com/zcj/iri0xmr7pmjj/agent/people/count \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{"locations": [{"type": "country", "value": "United States"}], "job_titles": ["Head of Sales"]}'
```

Each `locations` entry takes `type` (`city`, `state` or `country`) and `value`. The response is a JSON object with `total_results`, the number of matching people, and a `ranked` boolean. A call funded from credit carries a `zc-billing` header in its plan shape:

```
zc-billing: {"status":"settled","fundingSource":"credit","chargedUsd":"<debited for this call>","remainingCreditUsd":"<balance after the debit>"}
```

This example request drew $0.058 from Prepaid lead data credit, the `chargedUsd` its `zc-billing` header reported. A `status` of `settling` means the final amounts are not stamped yet.

## What is charged when

- Reading the catalog and the API reference costs nothing. A charge comes from paying a 402 or from a call drawing on your credit.
- The Domain Email Finder, Mobile Number Finder, People Search and People Count are sold on plans. Without a covering plan they answer `403 plan_required`.
- A delivered response with no `zc-billing` header billed nothing.
- A `503` means the service was temporarily unavailable, and you were not charged.
- Paying a 402 completes the purchase and accepts the terms listed in [Terms](https://agents.scalelist.com/zcj/iri0xmr7pmjj/terms.md).

## Pricing and payment errors

| Code | Meaning | Action |
| --- | --- | --- |
| `401 bearer_required` | The call carried no agent credential | Register at [auth.md](https://agents.scalelist.com/zcj/iri0xmr7pmjj/auth.md), one free call, then retry with the bearer |
| `403 plan_required` | No plan you hold covers the call. `plans` lists those that do. | Fund Prepaid lead data, then retry |
| `409 payment_rail_unavailable` | The charge is under the $0.50 card floor, or no card lane is available | Buy Prepaid lead data credit by card and call against it with your bearer |
| `usage_exhausted` | The credit balance ran out | Top up with `POST https://agents.scalelist.com/zcj/iri0xmr7pmjj/extend` |
| `amount_below_minimum`, `amount_below_card_minimum` | `amountUsd` is under $1, or under $1 by card | Raise the amount |
| `amount_not_cent_increment` | `amountUsd` is not whole cents | Round to whole cents |

Every other code is in [the error reference](https://agents.scalelist.com/zcj/iri0xmr7pmjj/errors.md).

## Frequently asked questions

### How much does an email cost on Scalelist?

The B2B Email Finder, for a person you name, runs at $29 per 500 requests, and only lookups that return an email are charged. The Domain Email Finder, for the emails known at a company, costs $0.058 for each email it returns. Each email comes back labelled `Valid` or `Risky`.

### Is a lookup that finds nothing charged?

No, for the B2B Email Finder and the Mobile Number Finder: a `"Not found"` email or a `"not_found"` number is free. The Domain Email Finder and People Search charge only for the emails or profiles they return. People Count is the exception, charged once per call however many people match.

### Can I pay for each call by card?

A card pays a single call only when its 402 is $0.50 or more, and a call quoted under that floor is refused with `409 payment_rail_unavailable`. For a run of lookups, fund Prepaid lead data by card from $1 and let each call draw on the balance.

### Do I need a Scalelist account or API key?

No. Every call carries the agent credential the storefront issues; [auth.md](https://agents.scalelist.com/zcj/iri0xmr7pmjj/auth.md) registers one for free, with no email needed. The storefront forwards each call to Scalelist's API, so no Scalelist API key is needed.

### Are there free credits or a free tier?

No meter on either plan includes free units. Industry Lookup is free for registered agents, and it checks which industry categories your words will match before you run a paid People Search or People Count.

## Keep reading

- [The buyer skill](https://agents.scalelist.com/zcj/iri0xmr7pmjj/SKILL.md): the full purchase flow
- [How to pay](https://agents.scalelist.com/zcj/iri0xmr7pmjj/payment.md): card payment, plans, top-ups and the `zc-billing` header
- [Services and pricing](https://agents.scalelist.com/zcj/iri0xmr7pmjj/services): each service's full price matrix
- [Agent identity](https://agents.scalelist.com/zcj/iri0xmr7pmjj/auth.md): register, claim and exchange your credential

---

Updated 2026-11-20. All Scalelist guides: https://agents.scalelist.com/guides.md. Storefront: https://agents.scalelist.com/zcj/iri0xmr7pmjj/llms.txt.
