RevealEmail API

Pricing

Exactly what the website charges: one credit is one full email report. Credits do not expire, there is no monthly fee, and nothing renews.

Or any amount from 3 to 50 credits, priced the same way as on the pricing page.

Authentication

Create a key in the dashboard and send it as a bearer token. The secret is shown once, at creation — we store only a hash of it, so a lost key is replaced rather than recovered.

Authorization: Bearer sk_live_…

JSON. The address is normalised before the lookup, so case and surrounding whitespace do not matter.

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"}'

Parameters

• email string · required

  A single address. One credit per address.

Response

{
  "success": true,
  "lookup_id": "9f2c…",
  "type": "email",
  "credits_remaining": 42,
  "data": { "…": "the same report the website returns" }
}

Check your balance

curl https://revealemail.com/api/v1/credits \
  -H "Authorization: Bearer sk_live_your_key"

Errors

A credit is spent only when a lookup actually runs. Every failure after the deduction — provider error, timeout, anything — refunds it.