Get User by ID

Retrieves detailed information about a specific user by their ID.

Request

GET /v2/users/users/{user_id}

Parameters

Name	Type	In	Description
user_id	string	path	Required. The ID of the user to retrieve

Headers

Name	Description
Authorization	Required. Bearer token for authentication
User-Agent	Optional. Client application identifier

Example

curl --request GET \
  --url '\{\{baseUrl\}\}/v2/users/users/680c02896d91ca0145cfeb81' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'User-Agent: insomnia/11.5.0'

Response

A successful response returns the user information:

{
  "id": "680c02896d91ca0145cfeb81",
  "name": "Tom",
  "surname": "Hardy",
  "email": "user@apex.com",
  "address": "0xa112983907944387b64ba512daf256b3f28f93f5",
  "identity_number": "11111111111",
  "kyc": {
    "is_verified": true,
    "token_sent": true,
    "token_sent_at": "2025-04-25T21:53:47.356Z",
    "token_tx_hash": "0xf42d9234c0b22da68cfe7bf22975cad881d219a711c72b39d6c9a741e0344b62"
  }
}

Response Fields

Field	Type	Description
id	string	Unique identifier for the user
name	string	User's first name
surname	string	User's last name
email	string	User's email address
address	string	User's blockchain wallet address
identity_number	string	User's national identity number
kyc	object	Know Your Customer verification information
kyc.is_verified	boolean	Whether KYC verification is completed
kyc.token_sent	boolean	Whether verification token was sent
kyc.token_sent_at	string	ISO 8601 timestamp when token was sent
kyc.token_tx_hash	string	Blockchain transaction hash for token verification

Status Codes

Status Code	Description
200	Success - User information retrieved successfully
400	Bad Request - Invalid request parameters
401	Unauthorized - Invalid or missing authentication token
404	Not Found - User ID does not exist
500	Internal Server Error