Disposable addresses

Disposable address check

The service tests if a mail address belongs to a domain providing temporary, disposable email addresses.

Syntax /svc/2.0/address/disposable/<address>
Example /svc/2.0/address/disposable/foo@bar.com
Parameter An ASCII email address as last part of the URL

Result

<disposableStatus> 
<infoId>bar.com</infoId> 
<result>1</result> 
</disposableStatus>

or

{"infoId": "bar.com", "result": 1}
  • result: the evaluation result
    • 0: not a disposable email address
    • 1: is a disposable email address
  • infoId: if result == 1, this contains the ID (domain name) for looking up more information about a disposable resource

Functionality

If a match is found a positive result (1) is returned. The ID of the matching entry, the domain name, is also returned for further lookup.

Information about a disposable resource

The disposable info API call returns information about disposable resources.

Syntax /svc/2.0/info/disposable/<id>
Example /svc/2.0/info/disposable/bar.com
Parameter An ID (domain name) as the last part of the URL

Result

<disposableInfo> 
<country>USA</country> 
<id>bar.com</id> 
<owner>Dosposabil</owner> 
<remarks>No sign-in necessary</remarks> 
<validity>3T</validity> 
<disposableInfo>

or


"country":"USA", 
"id":"bar.com", 
"owner":"Dosposabil", 
"remarks":"No sign-in necessary", 
"validity":"3T" 
}

The structure of the result document is:

  • id: the ID of the resource, which is also the domain name representing the provider
  • owner: the name of the organization providing the disposable addresses
  • country: country name for the provider organization/domain
  • remarks: further details about the resource
  • validity:lifetime for the disposable addresses provided by this domain

Functionality

If no data is available for an ID the server will signal this with HTTP response code 204 (No Content) and return no result (null).