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

# How many credits does a lead cost?

> One credit for every lead your source finds an email for, plus five more only when it also finds a phone number.

export const Screenshot = ({id, alt, caption, frame = 'browser', url, marks = [], lang = 'en', workspace = 'northwind-outbound'}) => {
  const src = `/images/screenshots/${lang}/${id}.png`;
  const chrome = url ? `app.pipelime.ai/${workspace}${url}` : 'app.pipelime.ai';
  return <figure className={`pl-shot pl-shot--${frame} not-prose`}>
      <div className="pl-shot__frame">
        {frame !== 'bare' && <div className="pl-shot__bar">
            <span className="pl-shot__dots">
              <span className="pl-shot__dot" />
              <span className="pl-shot__dot" />
              <span className="pl-shot__dot" />
            </span>
            <span className="pl-shot__url">{chrome}</span>
          </div>}
        <div className="pl-shot__media">
          <img src={src} alt={alt} loading="lazy" />
          {marks.map(mark => <span key={mark.n} className="pl-shot__mark" style={{
    left: `${mark.x}%`,
    top: `${mark.y}%`
  }} aria-hidden="true">
              {mark.n}
            </span>)}
        </div>
      </div>
      {caption && <figcaption className="pl-shot__caption">{caption}</figcaption>}
    </figure>;
};

A [lead source](/en/ai-agents/lead-sources) charges one credit for every lead it attaches an email to, and five credits more only when you asked it for a phone number and one actually comes back. A lead it never finds an email for costs nothing.

<div className="pl-availability">
  <div className="pl-availability__row">
    <div className="pl-availability__label">Where</div>
    <div className="pl-availability__value"><span className="pl-path">Outreach<span className="pl-path__sep">→</span>AI Agents</span></div>
  </div>

  <div className="pl-availability__row">
    <div className="pl-availability__label">Your role needs</div>
    <div className="pl-availability__value">Read access to AI Agents <code>read-campaigns</code>. Admin, Member and Viewer have it by default.</div>
  </div>

  <div className="pl-availability__row">
    <div className="pl-availability__label">To create or change</div>
    <div className="pl-availability__value"><code>create-campaigns</code> to add one, <code>update-campaigns</code> to change one, on top of the permission above.</div>
  </div>

  <div className="pl-availability__note">If you cannot find this in your sidebar, your workspace may have a custom menu configuration. Contact support and we will check it for you.</div>
</div>

<Screenshot id="finding-leads/credits-per-lead--cost-line" frame="bare" alt="The phone-enrichment panel inside the Add a source dialog: a switch labeled Also find phone numbers, an amber line spelling out the extra cost of turning it on, and a grey helper line underneath explaining that the email is never replaced by the phone number" caption="The switch (1) is off by default, but the panel states the price (2) either way. You see the cost before you decide, not after." marks={[{ n: 1, x: 92, y: 18 }, { n: 2, x: 6, y: 50 }]} />

## How it behaves

### One credit, the moment a lead gets an email

A lead source finds companies, and each company it finishes researching starts its own hunt for
people inside it. Within one company those hunts run as a queue: one contact, then the next.
Every one of them that ends with an email attached to a lead costs one credit. That is the base
charge, and the only charge for a lead you didn't also ask for a phone number on.

Researching the company itself is not charged. Only contacts are.

How many contacts one company can produce is its own control, **Contacts per company**: it caps
how many people in that company can end up with an email, and the search stops working through
that company's list once the cap is reached. You'll find it on the **Pace** step of the
create-agent wizard, and on **Add a source** it sits inside the **Pace & limits** section, which
starts closed. With phone lookup off, the field's own helper text says as much: "each contact
uses 1 credit". Set it to three and a company that yields three leads with emails can add up to
three separate one-credit charges. The charge is per lead, not per company.

### What skips the charge

A search that never attaches an email is never charged: nothing came back, or the address turned
out to be on your workspace's blocked-domain list. Nor is a search we skip outright, which we do
once a company has racked up enough failed email checks in a row that trying the next person there
is unlikely to help. One address that checks out clean resets that streak.

The bar to actually skip a charge is narrower than "verified," though. Only a check that comes
back failed discards the email. Everything short of that (a clean verified result, or one
that comes back inconclusive with no firm answer either way) still leaves the email in place, and
that lead still costs the credit. [What consumes credits](/en/billing/what-consumes-credits)
covers what those verdicts mean in full, including for leads that never went through a lead source
at all.

### Turning on phone lookup

Phone lookup is off for every lead source until you turn it on yourself, with the **Also find
phone numbers** switch. You'll meet it wherever you set a source up: the **Pace** step when you
first create an agent, and **Add a source** on an existing one. In that dialog it deliberately
sits out in the open rather than inside **Pace & limits**: it's the one control there that changes
what a lead costs, and the product keeps that in view instead of disclosing it behind a closed
section.

Turning it on doesn't touch the email side of the price. Every lead your source finds still gets
the same email search, at the same one credit, whether the switch is on or off. The panel says as
much in its own words: "The email is always included and is never replaced by the phone number."
What the switch adds is a second, separate search, run right after the email one succeeds: an
attempt to find a direct phone number for that same lead.

### The phone credit only lands when a number comes back

That second search is billed only on success. A lookup that comes back empty costs nothing on top
of the email credit. You don't pay for finding out a lead has no number on file, only for one you
are actually handed.

There's also a ceiling on how much one lookup can add. The enrichment behind it can return more
than one number for a lead (a mobile, a work line, a direct line), but a lead source only ever
bills you for one of them. So the most one lead can cost a lead source is the one-credit email
plus the five-credit phone number, no matter how many numbers the lookup turns up. That cap
belongs to lead sources: the manual **Get Phone** button on a lead's own page works differently
and bills every number it finds. See
[Get a phone number for a lead](/en/leads/get-a-phone-number).

If the workspace doesn't have five credits to spare when the lookup is due, the lookup is skipped
instead of half-charged. The lead keeps its email and its one credit.

### Where to see what you've spent

<Screenshot id="finding-leads/credits-per-lead--credits-popover" frame="bare" alt="The credits popover open from the header: a gold coin badge next to a large number of credits remaining, and a progress bar underneath showing credits used against the total" caption="Click the coin badge in the header to see your workspace's current balance." marks={[{ n: 1, x: 22, y: 26 }]} />

The number beside the coin (1) is the same balance every credit charge on this page draws from.
Click it to see that figure with the billing period's progress bar underneath it. The balance is
per workspace, so switching workspaces switches the figure.

## Limits

|                                                            |                                                                         |
| ---------------------------------------------------------- | ----------------------------------------------------------------------- |
| Base charge, per lead a source finds an email for          | 1 credit                                                                |
| Researching a company                                      | Not charged                                                             |
| What skips the charge                                      | No email found, a blocked domain, or a failed verification check        |
| A verified or inconclusive email                           | Still costs the credit: only a failed check is free                     |
| After enough failed checks in a row at one company         | Remaining contacts there are skipped, and not charged                   |
| Phone lookup                                               | Off by default: opt in per lead source with **Also find phone numbers** |
| Phone charge                                               | 5 credits, only when a number is actually found                         |
| Numbers found beyond the first, for one lead               | Not billed: a lead source pays for at most one                          |
| Same lookup from the **Get Phone** button on a lead's page | Bills every number found, not just one                                  |

## Related

<CardGroup cols={2}>
  <Card title="What consumes credits" icon="coins" href="/en/billing/what-consumes-credits">
    The fuller picture: including leads that never went through a lead source, and what stays free.
  </Card>

  <Card title="Also find phone numbers" icon="toggle-left" href="/en/finding-leads/phone-enrichment-option">
    Turning the toggle on, step by step, with the before-and-after cost line.
  </Card>

  <Card title="Get a phone number for a lead" icon="phone" href="/en/leads/get-a-phone-number">
    The manual button on one lead's page, and how its billing differs from what a lead source runs
    automatically.
  </Card>

  <Card title="Plans and credits overview" icon="layers" href="/en/billing/plans-and-credits-overview">
    What your plan grants, and where credits fit next to your other limits.
  </Card>
</CardGroup>
