Docs/API Reference/Verify Email
POST/v1/verify

Verify a single email address in real-time. Returns comprehensive verification data including deliverability status, domain information, and confidence score.

Credits

1 per request

Response Time

500ms - 3s

Rate Limit

100/min

Request

Headers

NameRequiredDescription
AuthorizationRequiredBearer token with your API key
Content-TypeRequiredapplication/json

Body Parameters

ParameterTypeRequiredDescription
emailstringRequiredEmail address to verify
timeoutintegerOptionalTimeout in seconds (5-60, default: 30)

Try It

Live API

Use @sandbox.rocketverifier.com emails to test without an API key. Real emails require authentication.

Code Examples

curl -X POST https://api.rocketverifier.com/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "deliverable@sandbox.rocketverifier.com"}'

Response

200Success

FieldTypeDescription
emailstringThe verified email address
statusstringdeliverable, undeliverable, risky, or unknown
reasonstringDetailed reason code
domainobjectDomain information (name, acceptAll, disposable, free)
providerstringEmail service provider (e.g., google.com)
scoreintegerConfidence score (0-100)

Error Responses

401Unauthorized - Invalid or missing API key
402Payment Required - Insufficient credits
429Too Many Requests - Rate limit exceeded