---
title: "Get a BotInstance (v2)"
method: GET
path: "/v2/bot-instances/{id}"
tags: ["Agents"]
---

# Get a BotInstance (v2)

`GET /v2/bot-instances/{id}`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/bot-instances/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns one BotInstance by id. Readable by the agent's owner, whoever
manages the bot's App (its creator, an admin with
`appSettings.read`, a B2B Server JWT for it) and `isSuperAdmin.read`;
anyone else gets 404. Supports `User JWT` and `B2B Server JWT`.

## Path parameters

- `id` string, required

## Response `200`

```
{ ok: true, botInstance: { id, agentId, appId, userId, xmppUsername, status, joinedRooms, lastActiveAt, createdAt, updatedAt } }
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: ``` { error: 'BotInstance not found', code: 'BOT_INSTANCE_NOT_FOUND' } ```
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)