> ## 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.

# Retrieve a user

> Read one member, guest, or integration bot.

Reads a member, guest, or integration bot in the team, including bots of deleted integrations. 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.

**id** `string` *required*

The user ID.

## Response

| `type` | Fields |
| - | - |
| `person` | `name`, `avatar_url`, `person`. With user information set to **With email**, `person` has `email` and `email_verified`. |
| `bot` | `name`, `avatar_url: null`, `bot: {}` |

## Errors

| Status | `code` | Cause |
| - | - | - |
| 403 | `restricted_resource` | User information is set to **None**. |
| 404 | `object_not_found` | No such user. Users of other teams and the reserved automation ID also return 404. |

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/11111111-1111-4111-8111-111111111111 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "object": "user",
  "id": "11111111-1111-4111-8111-111111111111",
  "name": "Alex Kim",
  "avatar_url": null,
  "type": "person",
  "person": {
    "email": "person@example.com",
    "email_verified": true
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 404 theme={null}
{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find user with ID: 11111111-1111-4111-8111-111111111111.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


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