---
search:
  tags:
    - Chat bot
    - GET
seo:
  description: >-
    Whether the chat bot is switched on, and per platform (Twitch, Kick) the
    chat it's in and… Reference for the GET /bot endpoint in the TipPage
    Developer API.
sidebar:
  label: Bot status
  badge: GET
title: Bot status
type: openapi-operation
---
Whether the chat bot is switched on, and per platform (Twitch, Kick) the chat it's in and the identity it speaks as - on Twitch the shared TipPageBot or the streamer's linked custom bot, on Kick always the TipPage app account. A platform the streamer hasn't connected is `null`. Any valid key.

`GET /bot`

**Responses**

- `200` — Bot status.
- `401` — Missing or invalid credential (\`missing\_api\_key\` / \`invalid\_api\_key\`, or \`invalid\_token\` for an expired/revoked OAuth access token).
- `429` — Rate limit exceeded - check the \`RateLimit-\*\` headers.

Response example, 200 · Custom bot on Twitch, app account on Kick:

```json
{
  "bot": {
    "enabled": true,
    "platforms": {
      "twitch": {
        "enabled": true,
        "channel": "somestreamer",
        "identity": {
          "type": "custom",
          "login": "somebot",
          "display_name": "SomeBot"
        }
      },
      "kick": {
        "enabled": false,
        "channel": "somestreamer",
        "identity": {
          "type": "default",
          "login": "tippagebot",
          "display_name": "TipPageBot"
        }
      }
    }
  }
}
```

Response example, 200 · No Kick channel connected:

```json
{
  "bot": {
    "enabled": true,
    "platforms": {
      "twitch": {
        "enabled": true,
        "channel": "somestreamer",
        "identity": {
          "type": "default",
          "login": "tippagebot",
          "display_name": "TipPageBot"
        }
      },
      "kick": null
    }
  }
}
```
