This API may be used for looking up name and address information for phone numbers.
Supported countries: Norway
The TeletopiaSMS Number Information Lookup Service is a HTTP based API available as HTTPS (SSL encrypted) as well as HTTP. We recommend using HTTPS whenever possible as HTTP is mainly provided for compatibility with older systems.
Should the primary end-point become unreachable, we have backup end-points available. We encourage the Content Providers to design their systems to switch URL's whenever they lose connection. Do not try to load-balance by sending round robin or random. Use secondary as a fallback if primary fails.
The available end-points are:
| HTTPS primary | https://api1.teletopiasms.no/service/numberlookup/ |
| HTTPS secondary | https://api2.teletopiasms.no/service/numberlookup/ |
| HTTPS tertiary | https://api3.teletopiasms.no/service/numberlookup/ |
| Insecure primary | http://api1.teletopiasms.no/service/numberlookup/ |
| Insecure secondary | http://api2.teletopiasms.no/service/numberlookup/ |
| Insecure tertiary | http://api3.teletopiasms.no/service/numberlookup/ |
Requests may be made using either method POST or GET, but POST is preferred.
$ curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "username=XXXX&password=XXXX&number=47XXXXXXXX" https://api1.teletopiasms.no/service/numberlookup/
{
"sector": "P",
"firstName": "Ola",
"lastName": "Nordmann",
"address": "Storgata",
"postalCode": "0161",
"city": "Oslo",
"numbers": [
"+47XXXXXXXX"
]
}
| Parameter | Description |
|---|---|
| username | Gateway username |
| password | Gateway password |
| number | Phone number to look up |
The response to the request is a JSON object containing the information listed below, or null, if no information is found for the number.
The response will be of type Content-Type: application/json with a HTTP status code 200 for all successfull requests.
| Parameter | Sector | Description |
|---|---|---|
| sector | P/B | P for private and B for business |
| firstName | P | First name of person |
| middleName | P | Middle name of person |
| lastName | P | Last name of person |
| companyName | B | Company name |
| address | P/B | Registered address of person or business |
| postalCode | P/B | Registered postal code of person or business |
| city | P/B | Registered city of person or business |
| numbers | P/B | All known phone numbers for this person or business |