Public Service Domains

Public service domain check

The service tests whether an email address belongs to a domain related to a public service organization.

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

Result

<publicServiceDomainStatus>
    <infoIds>
        <infoId>5000</infoId>
    </infoIds>
    <result>1</result>
</publicServiceDomainStatus>

or

{"infoIds": [5000], "result": 1}
  • result: the evaluation result
    • 0: not a public service domain
    • 50: probably a public service domain
    • 100: a public service domain
  • infoIds: if result > 0, this element contains IDs for looking up more information about a public service resource.

Functionality

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

Information about a public service resource

The public service info API call returns information about public service organization resources.

Syntax …/svc/2.0/info/publicservicedomain/<id>
Example …/svc/2.0/info/publicservicedomain/5335
Parameter An ID (number) as the last part of the URL

Result

<publicServiceDomainInfo>
    <addressCity>München, Landeshauptstadt</addressCity>
    <addressState>Bayern</addressState>
    <addressZipCode>80331</addressZipCode>
    <countryCode>de</countryCode>
    <description>Kreisfreie Stadt</description>
    <id>5335</id>
    <orgName>München, Landeshauptstadt</orgName>
</publicServiceDomainInfo>

or

{
     "addressStreet":null,
     "addressCity":"München, Landeshauptstadt",
     "addressZipCode":"80331",
     "addressState":"Bayern",
     "countryCode":"de",
     "description":"Kreisfreie Stadt",
     "id":5335,
     "orgName":"München, Landeshauptstadt"
}

The result document address data and descriptions for the public service resources.

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 call will be documented as a business event (database table business_event) with type 125.