Quick Start Guide
Get started with RocketVerifier API in less than 5 minutes. Verify your first email with just a few lines of code.
Prerequisites
- A RocketVerifier account — sign up for free
- Your API key from the dashboard
1
Get Your API Key
Navigate to your dashboard and create a new API key. Your API key looks like this:
rv_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Keep your API key secret! Don't share it publicly or commit it to version control.
2
Make Your First Request
Use the /v1/verify endpoint to verify an email address. Here are examples in different languages:
cURL
curl -X POST https://api.rocketverifier.com/v1/verify \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com"}'Node.js
const response = await fetch('https://api.rocketverifier.com/v1/verify', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ email: 'user@example.com' })
});
const result = await response.json();
console.log(result.status); // 'deliverable', 'undeliverable', etc.Python
import requests
response = requests.post(
'https://api.rocketverifier.com/v1/verify',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
json={'email': 'user@example.com'}
)
result = response.json()
print(result['status']) # 'deliverable', 'undeliverable', etc.3
Handle the Response
A successful response will look like this:
200 OKResponse
{
"email": "user@example.com",
"status": "deliverable",
"reason": "accepted_email",
"domain": {
"name": "example.com",
"acceptAll": "no",
"disposable": "no",
"free": "no"
},
"account": {
"role": "no",
"disabled": "no",
"fullMailbox": "unknown"
},
"dns": {
"type": "MX",
"record": "aspmx.l.google.com."
},
"provider": "google.com",
"score": 95
}Understanding the Response
status— The verification result: deliverable, undeliverable, risky, or unknownscore— Confidence score from 0-100provider— The email service provider (Google, Microsoft, etc.)reason— Detailed reason for the verification status