> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brand-wallet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a user

> Returns a single user of the organization your access token is scoped to, by id.

```http theme={null}
GET $BASE_URL/v1/users/:id
```

**Returns a single user of your access token's organization. The shape is identical to a [List users](/api/list-users) item.**

> **Auth:** `Authorization: Bearer <accessToken>` — an organization-scoped token from [Authentication](/api/authentication).

### Path parameters

| Parameter | Type | Description |
| - | - | - |
| `id` | string | **Required.** The user's id (UUID). |

### Example

```bash theme={null}
curl --request GET \
  --url "$BASE_URL/v1/users/fa000708-10f6-47ea-a35d-d3e1acbd4be5" \
  --header 'Authorization: Bearer <accessToken>'
```

### Response

```json theme={null}
{
  "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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.