NameAPI is a web API
to handle people's names
in your software.

News

16.12.2024

Dictionary Update: Armenian Names

The Armenian language, part of the Indo-European family, stands out and forms its own branch....


18.11.2024

Dictionary Update: Ukrainian Names

A member of the East Slavic family, the Ukrainian language shares deep historical roots with...


04.11.2024

New Python Client Library Released

We have implemented a Python client library, now available on PyPI, providing easy access to...


22.10.2024

Software Version 10.6.0 Released

This update brings several improvements and new features designed to enhance the accuracy and...


11.10.2024

Discovering Czech Names

As part of the West Slavic group, the Czech language shares similarities with Slovak and Polish,...


   

Disposable Email Address Detector


       
Detects disposable email addresses "DEA", also known as trash email addresses such as "[email protected]".
See also the Swagger specification.
            
Detects thousands of known dea domains.

It classifies those as disposable which operate as a time-limited, web based way of receiving emails, for example, sign up confirmations.

Essentially every email address may be of temporary use. Even freemail providers like yahoo and gmail offer [temporary] aliases. However, those are personal and may be in use for a longer period of time, and can often not be detected as such.    
               
GET
       
We have integrated Swagger directly into our API.
Visit https://api.nameapi.org/rest/swagger-ui/.

   

Input

       
A syntactically valid email address.
Example: "[email protected]"
An invalid input exception is thrown if the address does not look like an email address.
       
The api-key also known as user-id. Authentication and accounting is performed on the server for this key.
Example: "32d21gc5071d7463ef6064c07ea98cb2-user1"

   

Output

   
   
Possible values:

The email address is known to be disposable.

The email address is known to be not disposable.
This value is returned when the user/domain combination is known to be of another type, for example freemail or a business.

The domain has not been classified yet.
This value is returned for many domains, and in almost all cases it means that the address is not disposable.

         {
            "disposable" : "YES"
         }