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

# List users

> Read team members and active integration bots.

Returns team members and the team's active integration bots, people first. Guests and bots of deleted integrations aren't in the list, but [Retrieve a user](https://developers.bottari.ai/api-reference/users/retrieve.md) can read them.

With user information set to **None**, the response is 403.

**Authorization** `string` *required*

`Bearer <token>`. See [Tokens](https://developers.bottari.ai/auth/tokens.md).

**Bottari-Version** `string`

Optional. Only `2026-03-11` is accepted. Without it, the current version is used. A different value returns 400.

**page\_size** `number` (default: 100)

1 to 100.

**start\_cursor** `string`

`next_cursor` from the previous response.

**results** `object[]`

User objects. Name, avatar, and email depend on the user information capability. See [User information](https://developers.bottari.ai/auth/capabilities.md#user-information).

**next\_cursor** `string | null`

The cursor for the next set.

**has\_more** `boolean`

`true` if there's more.

**type** `string`

Always `user`.

## Errors

| Status | `code` | Cause |
| - | - | - |
| 400 | `validation_error` | `page_size` isn't between 1 and 100. |
| 403 | `restricted_resource` | User information is set to **None**. |

See [Common rules](https://developers.bottari.ai/api-reference/overview.md#errors) for shared errors.

```bash curl theme={null}
curl "https://api.bottari.ai/v1/users?page_size=50" \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "object": "list",
  "results": [
    {
      "object": "user",
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Alex Kim",
      "avatar_url": null,
      "type": "person",
      "person": {}
    },
    {
      "object": "user",
      "id": "22222222-2222-4222-8222-222222222222",
      "name": "Order sync",
      "avatar_url": null,
      "type": "bot",
      "bot": {}
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "user",
  "user": {},
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 403 theme={null}
{
  "object": "error",
  "status": 403,
  "code": "restricted_resource",
  "message": "Insufficient permissions for this endpoint. This connection does not have user information capabilities.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


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