Email Lookup API

What you get

• The same report the website produces — API callers are not served a reduced tier.
• Linked accounts across the services we check, with names and avatars where they are public.
• Domain facts: mail provider, authentication records, disposable-provider detection.
• A flat price per call: one credit, however much the address turns out to be known.
• No query logging: we keep the endpoint, the status and the time, never the address or the report.

How does it work?

1. 01Create an account and a key

   Sign up at /developers/register/ with an email and a password — no card is needed for a key. In the dashboard, open the API keys tab and create one. The secret is shown exactly once, because only its SHA-256 hash is stored; a lost key is revoked and replaced rather than recovered.

   Illustration

2. 02Buy credits

   On the Billing tab, choose a pack — 3 credits for $3.95, 7 for $6.95, or any amount from 3 to 50 — and pay through Stripe. Credits land as soon as Stripe confirms and never expire. One credit is one lookup, whether the address comes back rich or nearly empty.

   Illustration

3. 03POST an address

   Send JSON with an `email` field and your key as a bearer token. The address is normalised before the lookup, so case and stray whitespace do not matter. One address per call — that is what a credit buys.

   Illustration

4. 04Read the report

   The response carries the report as structured JSON: the accounts found, the names and photos attached to them, breach appearances, and the domain and authentication block. Most lookups return in a few seconds. An address with no footprint is a real answer — it usually means the account is new or used nowhere else.

   Illustration

Code to copy

The same call in three places. A Postman collection is available too, with both endpoints and saved example responses.

curl -X POST https://revealemail.com/api/v1/lookup \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email":"someone@example.com"}'

const response = await fetch("https://revealemail.com/api/v1/lookup", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "someone@example.com" }),
});

const { success, data, credits_remaining } = await response.json();
if (!success) throw new Error("lookup failed");
console.log(data, credits_remaining, "credits left");

import os, requests

response = requests.post(
    "https://revealemail.com/api/v1/lookup",
    headers={"Authorization": f"Bearer {os.environ['RE_API_KEY']}"},
    json={"email": "someone@example.com"},
    timeout=90,
)

payload = response.json()
if payload["success"]:
    print(payload["data"])

A failed lookup never costs a credit. If the provider errors or the address is rejected, the deduction is reversed before the error reaches you — a 4xx or 5xx leaves your balance untouched.

Limits and guarantees

What people build with it

Questions

How much does the email lookup API cost?

One credit per lookup. Credits are $3.95 for three, $6.95 for seven, or any amount from 3 to 50 priced as on the pricing page. No subscription, no monthly minimum, and credits do not expire.

Is this an email verification API or a reverse lookup API?

Both, and the distinction matters. Verification asks whether an address can receive mail — domain, MX, authentication, deliverability — and the free check on the website covers that. The API's paid report goes further and answers who is behind the address: the accounts it is registered with, the names attached, breach appearances.

What happens if a lookup fails?

The credit is refunded automatically. The deduction happens immediately before the provider call, and every failure after that point reverses it before the error is returned.

Will every address return accounts?

No. An address created last week and used nowhere else has no footprint to find, and that is a legitimate result rather than an error. Coverage is strongest for addresses with years of signups behind them.

Does the person get notified that I looked them up?

No. No mail is sent to the address and nothing is disclosed to its owner. The lookup reads public and licensed sources only.

Do you store the addresses I look up?

No. The address goes to the provider and the report comes back in the response; neither is written to disk. Per call we record the endpoint, the status code, the key and the time — what billing and rate limiting need, and nothing else.

Can I use it for employment or tenant screening?

No. RevealEmail is not a consumer reporting agency, and results must not drive decisions about employment, credit, housing, tenancy or insurance. It is built for fraud and safety checks.

What do I do if a key leaks?

Revoke it in the dashboard — it stops working immediately — then create a replacement. Up to ten keys can be active at once, so rotating in production need not cause downtime.