Back to docs

API cookbook

Verify API examples — cURL, Python, JavaScript

Crawlable recipes matching the public OpenAPI at /openapi.json. Auth: Authorization: Bearer vf_…. Single verify is 1 credit; batch is 1 credit per email.

Verify one email (GET /api/v1/verify)

curl -sS -X GET "https://verifly.email/api/v1/verify?email=alex@acme.com" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Accept: application/json"

Batch verify ≤100 (POST /api/v1/verify/batch)

curl -sS -X POST "https://verifly.email/api/v1/verify/batch" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"emails":["alex@acme.com","jordan@acme.io","info@acme.com"]}'

Check credits

curl -sS -X GET "https://verifly.email/api/v1/credits" \
  -H "Authorization: Bearer vf_your_api_key"

Typical JSON shape

Fields may include result, email, disposable, role, catch_all, and provider-specific details. Always branch on result.

{
  "email": "alex@acme.com",
  "result": "deliverable",
  "disposable": false,
  "role": false,
  "catch_all": false
}

Also see full docs, MCP, and changelog. Contact: hello@veriflyemail.com