# Identify Recipient

Identify recipient should be used if you need to just check if one specific person is a Digipost user. This can be useful both prior to sending digital mail or as part of a process where (for example) a customer database is being updated with Digipost-addresses. You can identify a person by personal identification number (fødselsnummer), Digipost-address, or name and street address.

## Endpoint

https://api.digipost.no/identification

## Verb

HTTP POST

## Request

```
<?xml version="1.0" encoding="utf-8"?>
<identification xmlns="http://api.digipost.no/schema/v8" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <personal-identification-number>01013300001</personal-identification-number>
</identification>
```

## Reponse

```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<identification-result xmlns="http://api.digipost.no/schema/v8">
    <result>DIGIPOST</result>
</identification-result>
```

## Additional Comments

* You can be sure that the Digipost user returned in the response is the same person as was specified in the request.
* The [XSD](/api/schema) includes details on how a person can be identified by either Digipost-address or name and street address.
* The response can include the following results:
  * DIGIPOST -> The person is a Digipost user
  * IDENTIFIED -> The person was identified, but is not a Digipost user. The returned person-alias can be used in later identification.
  * UNIDENTIFIED -> Digipost was not able to identify the person based on the information included in the request.
