Du er ikke logget på
Geomatic Identity Validation Technical Documentation

On this page you will find information about our Identity Validation webservice.

Please also read this section to learn about authentication.

API Specification

The idea behind the web service is, to provide you with an easy solution to implement electronic identity validation. In this section you can read about how to create the request to the web service and what response you will get back.

Identity Validation Request

The identity validation API takes some input and returns an identity validation response containing validation codes for that input.

You can perform a call to the identity validation API by making a GET request of the form:

https://apps.conzoom.eu/api/v1/eidv/validate?in_adr={adr}&in_name={name}&in_dob={dob}&in_person_id={pid}

Query String Parameters

You are able to provide the following query parameters:

To be able to validate a person you need as a minimum to provide one of the following combinations of input:

Identity Validation Response JSON

For each request, the identity validation service returns a JSON object containing the validation codes for the input. The codes will never be null, and will always have a value.

The response of a validation request will look like this:

    {
        "person_found": {boolean},
        "name_adr_protected": {boolean},
        "person_status": {person_status_code}
        "adr": {address_validation_code},
        "name": {name_validation_code},
        "dob": {dob_validation_code},
        "person_id": {person_id_validation_code}
    }

person_found - a boolean value that indicates whether we could find the person or not. The possible values and their meaning are listed below:

name_adr_protected - a boolean value that indicates whether the person is name and address protected. For protected persons it's not possible to obtain their current name and address. The possible values and their meaning are listed below:

person_status_code - this is the status of the matched person - as provided by the underlying registry.

address_validation_code - validation code for the input address provided in the request. The possible values and their meaning are listed below:

name_validation_code - validation code for the input name provided in the request. The possible values and their meaning are listed below:

dob_validation_code - validation code for the date-of-birth provided in the request. The possible values and their meaning are listed below:

person_id_validation_code - validation code for the person identity number in the request. The possible values and their meaning are listed below: