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

# Query Business Users

> List all users with access to a business.

`GET /api/v1/businesses/:businessId/users`

## Parameters

### Path

| Name         | Type     | Required | Description     |
| ------------ | -------- | -------- | --------------- |
| `businessId` | `string` | Yes      | The business ID |

This endpoint has no query parameters.

## Request example

```shell theme={null}
curl --request GET 'https://payments.bleepay.com/api/v1/businesses/biz_abc123/users' \
  --header 'Authorization: Bearer <business_token>'
```

## Response

Returns an array of business user objects.

**Business user object:**

| Field       | Type     | Description                 |
| ----------- | -------- | --------------------------- |
| `id`        | `string` | Membership identifier       |
| `userId`    | `string` | User identifier             |
| `role`      | `string` | User's role in the business |
| `status`    | `string` | Membership status           |
| `createdAt` | `string` | ISO 8601 timestamp          |

### Example response

```json theme={null}
[
  {
    "id": "bu_xyz",
    "userId": "usr_abc123",
    "role": "ADMIN",
    "status": "ACTIVE",
    "createdAt": "2026-06-09T12:00:00.000Z"
  }
]
```