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 identification.
id_token	String	A JWT-token containing all of the relevant information about the identified user
name	String	The full name of the identified user
first_name	String	The first name of the identified user
last_name	String	The last name of the identified user
nin	String	The national identification number (alternatively called SSN) of the identified user

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": {
                "id_token": "jwt-token",
                "name": "Adeprimo Servicedesk",
                "first_name": "Adeprimo",
                "last_name": "Servicedesk",
                "nin": "01012000-1234",
              }
          }'

Response

Successful response

HTTP 200

{
  "item": {
    "trusted_identity_id": "64623c3017c0f863e8997e2d"
  }
}

Errors

This API uses the common error conventions of the Payway API

See common error responses