IP Shield

IP Shield

Overview

Email Domain Check API

Verify disposable email domains

The Email Domain Check API allows you to quickly verify whether an email address belongs to a known temporary or disposable email provider.

Disposable emails (also known as "burner" or "10-minute" emails) are frequently used by bots, fraudsters, and bad actors to bypass registration flows, abuse free trials, and pollute marketing databases. By checking the domain, you can proactively block spam signups, reduce bounce rates, and ensure you are only onboarding legitimate users.

Endpoint

Terminal
curl -X GET "https://ip-shield.riavzon.com/api/v1/check/email-domain/[email protected]" \
  -H "x-api-key: YOUR_API_KEY"

The [email protected] parameter in the URL path represents the email address or domain you want to verify.

Response Example

HTTP/1.1 200 OK
Content-Type: application/json

   {
  "ok": true,
  "date": "2025-06-12T00:00:00Z",
  "data": {
    "email": "[email protected]",
    "domain": "10minutemail.com",
    "is_disposable": true
  },
  "meta": {
    "total_credits": 10000,
    "credits_remaining": 9999
  }
}

Response Fields

ok
boolean
Indicates whether the request was successful (true).
date
string
ISO 8601 timestamp of when the response was generated.
data.email
string
The full email address that was analyzed.
data.domain
string
The extracted domain portion of the email.
data.is_disposable
boolean
true if the domain belongs to a known temporary or disposable email provider.
meta.total_credits
number
The total number of credits allocated to your account's plan.
meta.credits_remaining
number
The number of credits remaining in your current billing cycle.

Error Response

Error responses, such as bad requests or rate limits, return the following JSON format:

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "ok": false,
  "date": "2025-06-12T00:00:00.000Z",
  "reason": "Invalid email address format"
}

Error Fields

ok
boolean
Always false for error responses.
date
string
ISO 8601 timestamp of when the error occurred.
reason
string
A human-readable message explaining why the request failed.

Rate Limits

Geo Check API

Logo