Skip to content

Getting started

The PricklyMails API verifies email addresses in real time: syntax, MX records, SMTP deliverability, disposable and role detection, and typo suggestions, returned as a deliverability verdict and a quality score.

Base URL

All requests go to a single base URL over HTTPS.

https://api.pricklymails.com

Your first verification

Submit an address to POST /api/verify with your API key as a bearer token. Verification is asynchronous: the call returns a job_uuid, and you poll GET /api/verify/{uuid} until the job reaches a terminal status.

curl -X POST https://api.pricklymails.com/api/verify \
  -H "Authorization: Bearer pm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "email": "someone@example.com" }'

The response carries the job UUID and a Location header pointing at the poll URL:

{
    "job_uuid": "6f1c...",
    "status": "queued",
    "estimated_cost": 7
}

Poll the job until it is completed, then read the per-check result and the score. Prefer to be notified instead of polling? Register a webhook.

Next steps