Retrieve the authenticated identity

GET

/current-identity

Fetch the identity record belonging to the caller of the request. The identity is never taken from a path or query parameter — it is always resolved from identity_id on the verified JWT, so a caller can only ever retrieve their own identity, never another identity's record by guessing an id. Use this to display account/profile details in a dashboard or to confirm the current lifecycle status of the signed-in identity.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Responses

🟢200

application/json

The authenticated identity was found and returned successfully.

Bodyapplication/json

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/current-identity' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "Identity retrieved successfully",
    "status": "success",
    "data": {
        "id": "01HXYZ1234567890ABCDEFGHIJ",
        "name": "Jane Doe",
        "type": "user",
        "primary_email": "jane.doe@example.com",
        "reference": "IDT-8F2A1C7D",
        "parent": null,
        "status": "active",
        "created": 1722869520000,
        "updated": 1722869520000
    }
}

Modified at 2026-09-30 00:29:30

Update the authenticated identity's name

Confirm a money-moving action with PIN (and, where required, an authenticator code)