# Find a person's work email with Scalelist's email finder API

Scalelist's B2B Email Finder takes a person's name and company and returns their work email, labelled `Valid` or `Risky`. You are charged only when an email comes back, from Prepaid lead data credit bought by card at $29 per 500 requests. Send `POST https://agents.scalelist.com/zcj/i14g2fleub3v/agent/email/find` with the name, the company and your agent credential as a bearer.

## At a glance

- **Endpoint:** `POST https://agents.scalelist.com/zcj/i14g2fleub3v/agent/email/find`
- **Body:** a name (`first_name`, or `full_name`) and a company (`company_domain`, or `company_name`), or `linkedin_profile_url` on its own
- **Price:** $29 per 500 requests on Prepaid lead data. On Pay as you go, each call's 402 states its price, paid by card.
- **Billing:** charged only when an email is returned. `Not found` is free.
- **Payment:** card only. Prepaid lead data credit starts at $1 by card.
- **Credential:** your agent credential as `Authorization: Bearer <token>`, on every call
- **Response:** `requestId`, `email`, `firstName`, `lastName`, `domain`, `status`
- **Full purchase flow:** [the buyer skill](https://agents.scalelist.com/zcj/i14g2fleub3v/SKILL.md)

## Before you call

- **An agent credential.** Registering is one free call, anonymous if you like, with no email and no human step. [auth.md](https://agents.scalelist.com/zcj/i14g2fleub3v/auth.md) has the registration and the token exchange. A call without the bearer answers `401 bearer_required` before any price is quoted.
- **A plan, paid by card.** Two plans cover email lookups: Pay as you go and Prepaid lead data, whose credit starts at $1. [The buyer skill](https://agents.scalelist.com/zcj/i14g2fleub3v/SKILL.md) and [Card payment](https://agents.scalelist.com/zcj/i14g2fleub3v/payment/card.md) cover buying it.
- **No plan, no lookup.** A call with no plan answers `403 plan_required`, and the body's `plans` lists the plans that cover the call.

## Choose the fields to send

| You have | Send |
| --- | --- |
| First name, last name and the company website | `first_name`, `last_name`, `company_domain` |
| The whole name in one field | `full_name` with `company_domain` or `company_name` |
| A first name only | `first_name` with a company. `last_name` is optional. |
| The company name but not its website | `company_name` in place of `company_domain` |
| A LinkedIn profile URL | `linkedin_profile_url` alone, with no name or company |
| A row id or list name to match results back | `custom`, an object returned untouched with the result |

A name with no company is not enough to search on and answers `422`.

## Find the email

1. Send the lookup with your access token:

   ```bash
   curl -sS -X POST https://agents.scalelist.com/zcj/i14g2fleub3v/agent/email/find \
     -H 'Content-Type: application/json' \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -d '{"first_name": "Alex", "last_name": "Example", "company_domain": "example.com", "custom": {"row": "42"}}'
   ```

   With Prepaid lead data credit, the call draws down the balance. For paying on Pay as you go, follow [the buyer skill](https://agents.scalelist.com/zcj/i14g2fleub3v/SKILL.md).

2. Read the response. It has this shape:

   ```json
   {"requestId": "<id>", "email": "alex@example.com", "firstName": "Alex", "lastName": "Example", "domain": "example.com", "status": "Valid"}
   ```

   `domain` is the company domain the search ran on. `requestId` is Scalelist's id for the lookup.

3. Act on `status`:

   | `status` | `email` | Meaning | Charged |
   | --- | --- | --- | --- |
   | `Valid` | The work email | The address is verified | Yes |
   | `Risky` | The work email | The company's mail server accepts every address, so the address can't be fully verified | Yes |
   | `Not found` | `null` | No email was found | No |

4. Read the `zc-billing` response header for the amount billed. On credit it carries `fundingSource`, `chargedUsd` and `remainingCreditUsd`. A delivered response with no `zc-billing` header billed nothing.

## Boundaries

- The endpoint returns an email, not a phone number. Mobile numbers and people search are separate calls.
- `401 bearer_required` comes before any price, `Not found` is free and a `503` is not charged. Each of these is a safe place to stop.
- Card is the only way to pay. No upstream Scalelist API key is needed.

## Errors

| Response | Meaning | Action |
| --- | --- | --- |
| `401 bearer_required` | No agent credential on the call | Register at [auth.md](https://agents.scalelist.com/zcj/i14g2fleub3v/auth.md), then retry with the bearer |
| `401 invalid_token` | The access token expired or did not verify | Exchange your stored assertion for a fresh token |
| `403 plan_required` | No plan you hold covers the call | Buy one of the plans in the body's `plans`, then retry |
| `409 payment_rail_unavailable` | The charge is under the card floor of $0.50 | Buy Prepaid lead data credit by card, then retry with your bearer |
| `usage_exhausted` | The prepaid credit has run out | Top up with `POST https://agents.scalelist.com/zcj/i14g2fleub3v/extend` and `{"amountUsd": "..."}` |
| `422` | Not enough to search on | Add a company, or send `linkedin_profile_url` |
| `429` | Too many requests from this agent | Retry later |

## Next lookups

- **Emails at a whole company:** `POST https://agents.scalelist.com/zcj/i14g2fleub3v/agent/email/domain` with `company_domain` or `company_name` and an optional `limit` (default 10, up to 100). It needs no names and costs $0.058.
- **Mobile numbers:** `POST https://agents.scalelist.com/zcj/i14g2fleub3v/agent/phone/find` with a LinkedIn profile URL, a work email, or a name and company. It costs $0.58 and is charged only when a number is found.
- **People search:** `POST https://agents.scalelist.com/zcj/i14g2fleub3v/agent/people/search` by job title, seniority, industry, location and company, at $0.058. Size the audience first with `POST https://agents.scalelist.com/zcj/i14g2fleub3v/agent/people/count`, at $0.058.

These three are sold on Prepaid lead data credit only, so the same purchase covers them.

## Frequently asked questions

### Is an email lookup charged when no email is found?

No. A lookup is charged only when the response carries an email, with `status` `Valid` or `Risky`. A `Not found` response returns `email` as `null` and costs nothing.

### What is the difference between Valid and Risky?

`Valid` means the address is verified. `Risky` means the company's mail server accepts every address, so the returned address can't be fully verified. Both responses carry an email and both are charged.

### Does the email finder API need a Scalelist API key?

No. Every call carries the agent credential the storefront issues, which you register for in one free call and send as `Authorization: Bearer <token>`. No upstream API key is needed.

### How do I pay for email lookups?

By card. Buy Prepaid lead data credit with your bearer, starting at $1, and each found email draws down the balance at $29 per 500 requests. On Pay as you go, each call returns a priced 402 that a card pays when it is $0.50 or more.

### Can I find every email at a company without names?

Yes, with `POST https://agents.scalelist.com/zcj/i14g2fleub3v/agent/email/domain`. Send the company's domain or name, and up to 100 emails come back, each with its own `Valid` or `Risky` label, at $0.058 per email returned.

## Keep reading

- [Buyer skill](https://agents.scalelist.com/zcj/i14g2fleub3v/SKILL.md): the full purchase flow
- [Identity](https://agents.scalelist.com/zcj/i14g2fleub3v/auth.md): register and exchange the agent credential
- [How to pay](https://agents.scalelist.com/zcj/i14g2fleub3v/payment.md): card payments, credit and top-ups
- [Error reference](https://agents.scalelist.com/zcj/i14g2fleub3v/errors.md): every error code and what to do
- [B2B Email Finder API reference](https://agents.scalelist.com/zcj/i14g2fleub3v/services/email-finder/openapi.json): the request and response schemas

---

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