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": "jane.doe@acme.com" }'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": {
"email": "jane.doe@acme.com",
"result": "ok",
"resultCode": 1,
"subResult": "ok",
"quality": "good",
"riskScore": 5,
"catchAll": false,
"disposable": false,
"role": false,
"free": false,
"creditsCharged": 1
},
"error": null
}