Du er ikke logget på
The Geomatic Variables API
Teledata

Nummeroplysningsdata is Geomatic's version of the Danish phone book (in Denmark also called ยง31 data). Here you can find names, addresses and phone numbers as they would apear in a phone book.

Note, that not all persons in DK can be found in Nummeroplysningsdata, since a person can choose not to have his phone number in the phone book. Also, be aware that the information in nummeroplysnignsdata is collected by the tele operators, and is not coming from the official person registry (CPR). Therefore data may not be 100% correct in all cases.

Using The API

In this section we will through examples show how the API can be used to retrieve data from this universe.

Before reading on, know that this universe is provided by a different API than the other variable universes. The technical documentaion is not relevant here, and the normal arguments can not be used. All calls to this API needs BASIC authentication, API keys are not currently supported.

If the provided examples do not cover your needs, then please contact us and we will try to help you out.

Using the Nummeroplysnings API, you can:

Get name and address from a phone number

We look up nummeroplysningsdata based on a phone number (e.g. 26224775), you can do the following call:

https://public.retrify.dk/api/v1/GetByPhoneNumber?phoneNumber=26224775

An example of a response can be found below:

{
    "tele_phone": 87654321,
    "tele_phone_name": "Person Navnesen",
    "tele_phone_name_org": "",
    "tele_phone_adr": "Falskvej 1, 9999 By",
    "tele_phone_typ": "lan"
}

Find phone numbers from an address

If you have your address as text, for instance Vestergade 18 1, 8700, then you first need to geocode your input to identify the address. (If you have a KVHX or DAR-id then you can skip this part) This can be done using Geomatic's Danish geocoder as follows: 

https://apps.conzoom.eu/api/v1/match/dk/geocoder?in_adr=Vestergade 18 1, 8700&vars=kvhx,unadr_bbrid

This will match the address, and can also return any variable of interest as part of the result. In this case we either want the kvhx or the DAR id (unadr_bbrid) of the address, therefore we specify this using the vars argument:

See the geocoder documentation for further details about how to call the geocoder and interpret its response.

If you want to get all nummeroplysningsdata on the address you will take the either the kvhx or the DAR-id, and supply this in a look up of nummeroplysningsdata as follows.

KVHX Example:

https://public.retrify.dk/api/v1/GetBykvhx?kvhx=1010680006 STTV

DAR id Example:

https://public.retrify.dk/api/v1/GetByDarId?darId=0a3f509d-8caf-32b8-e044-0003ba298018

This returns a list of phone numbers with name and address information for each of them. The same name may apear multiple times if the person has multiple phonenumbers registered on the address.

An example of a list of phonenumbers can be found below:

[
    {
        "tele_phone": 12345678,
        "tele_phone_name": "Virksomhed A/S",
        "tele_phone_name_org": "Virksomhed A/S",
        "tele_phone_adr": "Falskvej 1, 9999 By",
        "tele_phone_typ": "mob"
    },
    {
        "tele_phone": 87654321,
        "tele_phone_name": "Person Navnesen",
        "tele_phone_name_org": "",
        "tele_phone_adr": "Falskvej 1, 9999 By",
        "tele_phone_typ": "lan"
    }
]

Check if a person is on the Robinson list

Before contacting a person you have looked up in Nummeroplysningsdata, you should check whether that person has opted out of direct marketing by verifying against the Danish Robinson List.

Once you have a name and address from a Nummeroplysnings lookup, pass them to the Robinson Wash API as a GET request. Use robinson_level=medium as a safe default unless your compliance requirements specify otherwise: 

https://apps.conzoom.eu/api/v1/wash/dk/robinson?in_name=Person Navnesen&in_adr=Falskvej 1, 9999 By&robinson_level=medium

The response tells you immediately whether the record should be excluded:

{
    "is_on_robinson": false,
    "result_code": "Success"
}

If is_on_robinson is true, do not send marketing material to this person at this address. If result_code is anything other than Success, the address could not be verified — treat the record with caution.

See the Robinson Wash API documentation for a full description of parameters, levels, and result codes.

Wash multiple persons against the Robinson list

When you have a list of persons retrieved from Nummeroplysningsdata and want to wash the entire list against the Robinson List in one go, use the batch endpoint. Make a POST request to: 

https://apps.conzoom.eu/api/v1/wash/dk/robinson/batch?robinson_level=medium

Provide each person as a key/value entry in the JSON body, using any identifier you like as the key:

{
  "person_1": {
    "in_name": "Virksomhed A/S",
    "in_adr": "Falskvej 1, 9999 By"
  },
  "person_2": {
    "in_name": "Person Navnesen",
    "in_adr": "Falskvej 1, 9999 By"
  }
}

The response gives a result for each person in your input:

{
  "person_1": {
    "is_on_robinson": false,
    "result_code": "Success"
  },
  "person_2": {
    "is_on_robinson": true,
    "result_code": "Success"
  }
}

Remove any record where is_on_robinson is true from your mailing before sending. Records where result_code is not Success could not be verified and should be reviewed manually.

See the Robinson Wash API documentation for a full description of parameters, levels, and result codes.