API Documentation

Authentication

Include your API key in every request using one of these methods:

Header (recommended)

Authorization: Bearer rb_live_your_key_here

Alternative header

X-Api-Key: rb_live_your_key_here

Rate Limits

Plan	Requests/min	Monthly limit
Free	10	100
Starter	60	5,000
Growth	120	25,000
Scale	300	100,000

POST/api/v1/email-validate

Email Validation

Validate an email address with syntax check, MX record verification, disposable email detection, role-based detection, and typo correction.

Parameters

Name	Type	Required	Description
`email`	string	required	Email address to validate (max 254 chars)

Request Body

JSON

{
  "email": "user@gmial.com"
}

Response

200 OK

{
  "email": "user@gmial.com",
  "valid": false,
  "verdict": "risky",
  "score": 40,
  "checks": {
    "syntax": true,
    "mx_records": false,
    "disposable": false,
    "role_based": false,
    "free_provider": false
  },
  "domain": "gmial.com",
  "mx_host": null,
  "suggestion": "user@gmail.com",
  "latency_ms": 52
}

Example

curl -X POST https://rebirthapi.com/api/v1/email-validate \
  -H "Authorization: Bearer rb_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@gmial.com"}'