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 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.