Retrieve User

Fetch a single user by ID.

GET/v1/users/{id}

Path parameters

Field	Type	Description
`id`required	string	Unique identifier of the user, e.g. `usr_01HX7...`

Request

curl https://api.vaultspay.ae/v1/users/usr_01HX71YM6FJ3A8W7T5K6NRB2DN \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

const user = await vp.users.retrieve('usr_01HX71YM6FJ3A8W7T5K6NRB2DN')

user = vaultspay.User.retrieve('usr_01HX71YM6FJ3A8W7T5K6NRB2DN')

Response

200 OK

{
  "id": "usr_01HX71YM6FJ3A8W7T5K6NRB2DN",
  "object": "user",
  "email": "ali@example.com",
  "first_name": "Ali",
  "last_name": "Hassan",
  "kyc": { "status": "approved", "level": "full" },
  "status": "active",
  "created_at": "2026-04-19T12:04:00Z"
}

Errors

HTTP	Code	Description
404	`not_found`	No user with that ID under your account.

Create User Update User