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).