ravn
Lead verification API

Is this lead real?

verify_lead checks everything you know about a lead in one call: the email (or finds it from a name and company), the phone number, whether the company’s website is live, and whether the person is listed on it. You get a verdict of good, review or bad, with every reason.

Start free: 1,000 lookups Read the docs

How it works

Four checks, one answer.

Send any mix of email, phone, name and company. It runs only the checks your input allows and charges one lookup per check.

  1. / 01

    The email

    Full email verification. No email but a name and company? It finds the work email from the company’s address pattern.

  2. / 02

    The phone

    Checks the number is real for its country and line type, and whether the company publishes the same number on its own website.

  3. / 03

    The company

    Reads the website: live or parked, closed notices, copyright year, published phones, emails and socials. A gmail.com address is never mistaken for a company.

  4. / 04

    The person

    Looks for the name on the company’s team and about pages and returns the title the company publishes.

Call it

Reasons, not just a score.

reasons lists what is wrong and signals lists what checks out, so an agent can explain its decision or fix the lead.

curl https://api.askravn.com/v1/tools/verify_lead \
  -H "Authorization: Bearer $RAVN_API_KEY" \
  -d '{"name": "Maria Lopez", "company": "acmeplumbing.ca",
       "phone": "416 555 0123", "country": "CA"}'

{ "status": "ok",
  "results": { "verdict": "review",
    "reasons": ["email_risky"],
    "signals": ["website_live", "phone_matches_website",
                "person_listed_on_website"],
    "email": { "email": "maria@acmeplumbing.ca", "status": "risky", … },
    "phone": { "phone": "+14165550123", "line_type": "landline_or_mobile", … },
    "company": { "name": "Acme Plumbing", "live": true, … },
    "person": { "name": "Maria Lopez", "title": "Owner" } },
  "metadata": { "lookups_used": 3 } }
FAQ

Questions about verify_lead.

All questions →

What makes a lead bad?

An invalid email, an invalid phone number, a parked or for-sale website, or a closed-business notice. Anything uncertain, like a catch-all domain or a person not listed on the site, is review, not bad.

How much does it cost?

One lookup for each check it runs: email, phone and company, so at most three. Ravn is $24 a month with 10,000 lookups included, then $1 per 1,000. A check that can’t run isn’t charged.

Can I verify a spreadsheet of leads?

Yes: npx ravn enrich leads.csv --tool verify_lead --map email=Email,phone=Phone,company=Website adds the verdict, reasons and signals as columns and resumes if it stops.

Does it call or text the number?

No. It never contacts anyone. For a live carrier check, use phone_to_carrier.

More tools, same key.

Every tool shares one account, one plan and one answer shape. See pricing →