POST
/v1/domain/checkCheck a domain's email configuration including MX records, mail server provider, and whether it accepts all emails (catch-all).
Credits
0 (free)
Response Time
200ms - 2s
Rate Limit
30/min
Request
cURL
curl -X POST https://api.rocketverifier.com/v1/domain/check \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "example.com"}'| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | string | Required | Domain name to check (e.g., example.com) |
Response
200 OK
{
"domain": "example.com",
"mx_records": [
{
"priority": 10,
"host": "aspmx.l.google.com"
},
{
"priority": 20,
"host": "alt1.aspmx.l.google.com"
}
],
"provider": "google.com",
"accept_all": false,
"disposable": false,
"has_valid_mx": true
}| Field | Type | Description |
|---|---|---|
| domain | string | The checked domain |
| mx_records | array | List of MX records with priority and host |
| provider | string | Email service provider (google.com, outlook.com, etc.) |
| accept_all | boolean | Whether domain accepts all emails (catch-all) |
| disposable | boolean | Whether domain is a disposable email provider |
| has_valid_mx | boolean | Whether domain has valid MX records |
Use Cases
Pre-verification Check
Check if a domain can receive emails before attempting full verification.
Disposable Detection
Block signups from disposable email domains at the domain level.
Catch-all Detection
Identify domains that accept all emails, which may require special handling.