Developer Documentation

Email Verification API
for Developers

Simple REST API. Official SDKs. Comprehensive documentation. Integrate email verification into any application in minutes.

Get API Key Free Quick Start Guide
RESTful API 5 Official SDKs <500ms Response 99.9% Uptime
Quick Start

Verify Your First Email in 30 Seconds

No SDK needed. Just make a simple HTTP request.

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

Response:

{
  "success": true,
  "data": {
    "email": "john@acme.com",
    "status": "deliverable",
    "reason": "accepted_email",
    "score": 95,
    "domain": {
      "name": "acme.com",
      "acceptAll": false,
      "disposable": false,
      "free": false
    },
    "provider": "google.com",
    "mxProvider": "google",
    "isReputableMx": true,
    "isRoleBased": false,
    "isCatchAll": false,
    "hasSPF": true,
    "hasDMARC": true,
    "hasDKIM": true,
    "authenticationScore": 95,
    "deliverabilityTier": "excellent",
    "suggestion": null,
    "processingTimeMs": 234
  }
}

Get your API key to start:

Get Free API Key
Endpoints

API Reference

Our REST API provides everything you need for email verification.

POST
/v1/verify

Verify a single email address in real-time

Docs →
POST
/v1/verify/batch

Submit a batch of emails for verification (up to 100K)

Docs →
GET
/v1/verify/job/{id}

Check the status of a batch verification job

Docs →
GET
/v1/verify/job/{id}/results

Download the results of a completed batch job

Docs →
GET
/v1/credits

Check your current credit balance

Docs →
POST
/v1/webhooks

Register a webhook endpoint for notifications

Docs →
View Full API Reference →
Official SDKs

SDKs for Every Language

Official, maintained SDKs with TypeScript support, retry logic, and comprehensive documentation.

N

Node.js

@rocketverifier/sdk

Full TypeScript support, ESM and CommonJS

npm install @rocketverifier/sdk
P

Python

rocketverifier

Full type hints, async support, context manager

pip install rocketverifier
P

PHP

rocketverifier/sdk

PSR-4 autoloading, PHP 8.0+

composer require rocketverifier/sdk
R

Ruby

rocketverifier

Ruby 3.0+, built-in retry logic

gem install rocketverifier
G

Go

github.com/rocketverifier/go-sdk

Idiomatic Go, context support

go get github.com/rocketverifier/go-sdk 
import RocketVerifier from '@rocketverifier/sdk';

const rv = new RocketVerifier('rv_live_xxxxx');

// Verify single email
const result = await rv.verify('user@example.com');
console.log(result.status);  // 'deliverable'

// Batch verification
const job = await rv.batch.create({
  emails: ['user1@example.com', 'user2@example.com'],
  webhookUrl: 'https://yoursite.com/webhook'
});
Features

Built for Developers

Every feature a developer needs for a smooth integration experience.

Lightning Fast

Single email verification in under 500ms. API response times under 50ms.

Secure Authentication

API keys with granular scopes. Keys are hashed and never stored in plain text.

Built-in Retry Logic

All SDKs include exponential backoff retry for transient failures.

Webhook Support

Get notified when batch jobs complete. HMAC signing for security.

Generous Rate Limits

Up to 1000 requests per minute on Enterprise plans.

99.9% Uptime SLA

Distributed infrastructure with automatic failover.

Real-Time

Webhooks for Real-Time Updates

Get notified instantly when batch jobs complete or when verification results are ready. All webhook payloads are signed with HMAC for security.

  • Job Completed - When a batch verification finishes
  • Credits Low - When your balance drops below threshold
  • HMAC Signed - Verify authenticity of every request
  • Retry Logic - Automatic retries on failed deliveries
Webhook Payload 
{
  "event": "job.completed",
  "timestamp": "2026-01-19T12:00:00Z",
  "data": {
    "jobId": "job_abc123",
    "status": "completed",
    "totalEmails": 10000,
    "results": {
      "deliverable": 8500,
      "undeliverable": 1200,
      "risky": 200,
      "unknown": 100
    },
    "downloadUrl": "https://..."
  }
}
Resources

Everything You Need to Get Started

API Reference

Complete endpoint documentation with examples

Code Examples

Sample code in every language we support

Postman Collection

Import and test every endpoint instantly

Changelog

Stay updated with API changes and new features

Ready to Start Building?

Get your API key and 100 free credits. Most developers integrate in under 10 minutes.

Get API Key Free Talk to a Developer
100 free credits Full API access No credit card required