Disposable Email Checker API

The Disposable Email Checker API allows you to check whether a given email address is from a disposable email provider.

/v1/disposableemailchecker GET

https://api.api-ninjas.com/v1/disposableemailchecker

Returns metadata for a given email address, including whether it is from a disposable email provider. We maintain a large database of hundreds of thousands of disposable domains and check against it for every email address.


Parameters

  • email  required

    Email address to check.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

  • domain  string

    Domain of the email address.

  • email  string

    Email address.

  • is_disposable  boolean

    Whether the email address is disposable.

Sample Request Live Demo!

email
https://api.api-ninjas.com/v1/disposableemailchecker?email=asdf@ingitel.com

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 { "email": "asdf@ingitel.com", "domain": "ingitel.com", "is_disposable": true }

Code Examples

1 2 3 4 5 6 7 8 9 import requests email = 'asdf@ingitel.com' api_url = 'https://api.api-ninjas.com/v1/disposableemailchecker?email={}'.format(email) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.