Skip to content

Getting started

Verify your first email address with the PricklyMails API in a few minutes: create a key, submit a job, and read the verdict and score.

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.

TEXT
https://api.pricklymails.com

Your first verification

  1. Submit the address

    Submit an address to POST /api/verify with your API key as a bearer token.

    Request
    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:

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

  2. Poll for the result

    Verification is asynchronous: the call returns a job_uuid, and you poll GET /api/verify/{uuid} until the job reaches a terminal status. 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