IWT Domains (ISP, Webmailer and Telecom Domains)

IWT check

The IWT check tests whether an address belongs to a domain of an ISP, a Webmail or a Telecom provider.

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

Result

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

or

{"infoId": "bar.com", "result": 1}

The result details are:

  • result: the evaluation result
    • 0: the domain doesn’t belong to known IWT provider
    • 1: the domain belongs to known IWT provider
  • infoId: if the result == 1, this contains the ID for looking up more information about a IWT resource

Functionality

The blacklist checks the domain of the address against the contents of the iwt table. If it matches a positive result is returned, which includes the ID for info lookup.

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

Information about a IWT resource

The IWT info API call returns information about various IWT resources, describing their market orientation and languages used.

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

Result

<iwtInfo>
    <id>bar.com</id>
    <owner>Webmailer Corp.</owner>
    <country>USA</country>
    <orientation>1</orientation>
    <languages>
        <language>en</language>
    </languages>
</iwtInfo>

or

{
  "id": "bar.com",
  "owner": "Webmailer Corp.",
  "country“: "USA“,
  "orientation“:1,
  “languages“:["en"]
}

The result document contains:

  • id: the ID of the resource, the domain name
  • owner: the name of the owning entity, provider
  • country: country name of the provider HQ
  • orientation: market orientation
    • 0: unknown
    • 1: national
    • 2: international
  • languages: if the orientation is national (1) this field can contain 1-3 language codes (ISO 639-1/2) describing the languages used in that national market

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