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