The disposable info API call returns information about disposable resources.

Syntax…/svc/2.0/info/disposable/<id>
Example…/svc/2.0/info/disposable/a:bar.com
ParameterAn ID (domain with prefix :a or mailexchanger name with prefix :m) 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 or mailexchanger name representing the provider
  • owner: the name of the maintaining entity, if known
  • country: country name for the provider organization
  • remarks: further details about the resource
  • validity:lifetime for the disposable addresses provided by this domain (not defined for mailexchangers)

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

Each execution of the check will be documented as a business event (database table business_event) with type 105.