validmail
      Zurück zur Startseite
      1. Help Center
      2. validmail

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