Create identification

/trusted_identity

Target audience: Developers

Release version: 4.7.0

Create Identification

Introduction

This endpoint registers a Tulo Identity, after a customer has performed a secure identification using for example Signicat.

URI

Environment	URI
Stage	https://payway-api.stage.adeprimo.se/external/api/v1/trusted_identity
Production	https://backend.worldoftulo.com/external/api/v1/trusted_identity

Requirements

Identity	Scope
No	/external/trusted_identity/w

Parameters

Name	Type	Description
user_info	Object	A object containing the information about the identified user.
name	String	The full name of the identified user
given_name	String	The first name of the identified user
family_name	String	The last name of the identified user
nin	String	The national identification number (alternatively called SSN) of the identified user
birth_date	DateTime	The birth date of the identified user
trusted_identity_reference	String	A unique reference connected to every performed identification. Size range: 16..1024 Allowed values: "/^[a-zA-Z-_0-9]+$/"

Curl Example

curl --request POST \
  --url https://payway-api.stage.adeprimo.se/external/api/v1/trusted_identity \
  --header 'accept: application/json' \
  --header 'authorization: Bearer token' \
  --header 'content-type: application/json' \
  --data '{
              "user_info": {
                "name": "Adeprimo Servicedesk",
                "given_name": "Adeprimo",
                "family_name": "Servicedesk",
                "nin": "01012000-1234",
                "birth_date": "2000-01-01T00:00:00"
              },
              "trusted_identity_reference": "5cb804811d41c82b5c518ea8"
          }'

Response

Successful response

HTTP 200

{
  "item": {
    "trusted_identity_id": "64623c3017c0f863e8997e2d",
    "trusted_identity_reference": "5cb804811d41c82b5c518ea8"
  }
}

Errors

This API uses the common error conventions of the Payway API

See common error responses