Prime VerifierPrime VerifierDevelopersAPI v1
Dashboard →
Get started / Quickstart

Quickstart

Verify your first email in under a minute. You need a Prime Verifier account and an API key, everything else is one HTTP call.

Create an API key

In your dashboard, open Profile, API Keys and create a key. Keep it secret, it carries your credits.

Make your first call

Send the address in the request body with your key in the X-API-KEY header.

Verify one email
curl -X POST "https://api.primeverifier.com/v1/verify/single" \
  -H "X-API-KEY: pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]" }'

Read the result

Branch on data.result and data.quality. ok is safe to send, invalid and disposable should be dropped, everything else is risky.

Response
{
  "status": "success",
  "data": { "result": "ok", "quality": "good", "risk_score": 5, "credits_charged": 1 },
  "error": null
}

Next steps