Get a user - BrandWallet

GET $BASE_URL/v1/users/:id

Returns a single user of your access token’s organization. The shape is identical to a List users item.

Auth: Authorization: Bearer <accessToken> — an organization-scoped token from Authentication.

Path parameters

Parameter	Type	Description
`id`	string	Required. The user’s id (UUID).

Example

curl --request GET \
  --url "$BASE_URL/v1/users/fa000708-10f6-47ea-a35d-d3e1acbd4be5" \
  --header 'Authorization: Bearer <accessToken>'

Response

{
  "id": "fa000708-10f6-47ea-a35d-d3e1acbd4be5",
  "fullname": "Jane Cashier",
  "email": "jane@example.com",
  "phone": "+905321112233",
  "status": 1,
  "organization": "ca5495d7-36ee-4f6d-8149-0dd082f7c745",
  "branch": "377ec3ad-28c8-4008-b3df-005a434dcf8b",
  "authBranches": ["377ec3ad-28c8-4008-b3df-005a434dcf8b"],
  "roles": [
    { "id": "e5e94c4a-7ab7-4568-bf5d-4ea61c2300af", "code": "branch_user", "name": "Branch User" }
  ],
  "opaqueId": "pos-user-7",
  "createdAt": "2026-10-06T12:31:34.711Z",
  "updatedAt": "2026-10-06T12:32:10.618Z"
}

Notes:

Requesting a user that does not exist returns entity_not_found (400); a user outside your organization returns auth_error (400).
organization, branch and authBranches are plain id strings.
Optional fields that have no value (phone, branch, authBranches, opaqueId) are omitted — you will not receive null.
roles contains only public-facing roles; internal system roles are not listed.
Credentials and internal account settings are never returned.

Last modified on October 8, 2026