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.

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

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": 87654321,
        "tele_phone_name": "Person Navnesen",
        "tele_phone_name_org": "",
        "tele_phone_adr": "Falskvej 1, 9999 By"
    }
]