> ## Documentation Index > Fetch the complete documentation index at: https://help.wotnot.io/llms.txt > Use this file to discover all available pages before exploring further. # List bots > Returns the bots in a WotNot account, with each bot's status, channels, language and owner. Use it to find a bot's ID or key, or to check which bots are active. ## OpenAPI ````yaml GET /v1/accounts/{account_id}/bots openapi: 3.1.0 info: title: WotNot API version: 1.0.0 description: 'WotNot API: List bots.' servers: - url: https://api.wotnot.io description: Production security: - bearerAuth: [] paths: /v1/accounts/{account_id}/bots: get: summary: List bots description: >- Returns the bots in a WotNot account, with each bot's status, channels, language and owner. Use it to find a bot's ID or key, or to check which bots are active. operationId: listBots parameters: - name: account_id in: path required: true description: >- The ID of the WotNot account whose bots you want to list. Use the account that your token belongs to. schema: type: string - name: Content-Type in: header required: true description: Always set this to `application/json`. schema: type: string enum: - application/json example: application/json responses: '200': description: >- Returns `ok` set to `true` and a `bots` list with one entry per bot in the account. content: application/json: schema: type: object required: - ok - bots properties: ok: type: boolean description: '`true` when the request worked. Errors return `false`.' example: true bots: type: array description: The bots in the account. Each item describes one bot. items: $ref: '#/components/schemas/Bot' example: ok: true bots: - bot_title: Appointment Booking channels: - name: WEB is_active: false bot_key: 7SgQLb4qUbp61059137828254t5QVE0H last_deployed_at: '2025-01-22 13:26:40.554000' is_inactive_by_system: false priority: 1 preferred_bot_language: label: English code: EN type: inbound outbound_type: null bot_owner: id: 14764 name: John Doe email: john.doe@gmail.com created_at: '2024-02-09 10:59:13.783000' preview_key: 6H7PD4WwTmsU105913782825Zk3KCj3t bot_id: 9633 '401': $ref: '#/components/responses/Unauthorized' components: schemas: Bot: type: object description: One bot in your WotNot account. required: - bot_title - channels - is_active - bot_key - last_deployed_at - is_inactive_by_system - priority - preferred_bot_language - type - outbound_type - bot_owner - created_at - preview_key - bot_id properties: bot_title: type: string description: The bot's name, as shown in WotNot. example: Appointment Booking channels: type: array description: The channels the bot is set up on. Each item is one channel. items: type: object required: - name properties: name: type: string description: The channel's name, for example `WEB` for your website. example: WEB is_active: type: boolean description: '`true` when the bot is turned on, `false` when it''s turned off.' example: false bot_key: type: string description: A unique key that identifies the bot. example: 7SgQLb4qUbp61059137828254t5QVE0H last_deployed_at: type: string description: >- When the bot was last deployed, in the format `YYYY-MM-DD HH:MM:SS.ffffff`, for example `2025-01-22 13:26:40.554000`. example: '2025-01-22 13:26:40.554000' is_inactive_by_system: type: boolean description: >- `true` when WotNot turned the bot off automatically, rather than someone on your team. example: false priority: type: integer description: The bot's priority number within the account. example: 1 preferred_bot_language: type: object description: The bot's main language. required: - label - code properties: label: type: string description: The language's full name, for example `English`. example: English code: type: string description: The language's short code, for example `EN`. example: EN type: type: string description: >- Which way the bot's conversations go, for example `inbound` for a bot that answers conversations your customers start. example: inbound outbound_type: type: - string - 'null' description: The kind of outbound bot. `null` when `type` is `inbound`. example: null bot_owner: type: object description: The person in your account who owns the bot. required: - id - name - email properties: id: type: integer description: The owner's user ID. example: 14764 name: type: string description: The owner's name, as shown in WotNot. example: John Doe email: type: string format: email description: The owner's email address. example: john.doe@gmail.com created_at: type: string description: >- When the bot was created, in the format `YYYY-MM-DD HH:MM:SS.ffffff`, for example `2024-02-09 10:59:13.783000`. example: '2024-02-09 10:59:13.783000' preview_key: type: string description: A separate key used for the bot's preview. example: 6H7PD4WwTmsU105913782825Zk3KCj3t bot_id: type: integer description: The bot's unique numeric ID. example: 9633 Error: type: object description: Returned whenever a request fails. required: - error - ok - status - message properties: error: type: string description: >- A short error code in capital letters, for example `UNAUTHORIZED`. Check this in your code to tell errors apart. example: UNAUTHORIZED ok: type: boolean description: Always `false` when something went wrong. example: false status: type: integer description: The HTTP status code, repeated in the body, for example `401`. example: 401 message: type: string description: What went wrong and how to fix it, in plain words. example: Invalid token. Provide the valid account token. responses: Unauthorized: description: >- The token is missing or wrong. Check that the `Authorization` header is `Bearer` followed by your account token. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: UNAUTHORIZED ok: false status: 401 message: Invalid token. Provide the valid account token. securitySchemes: bearerAuth: type: http scheme: bearer description: >- All of WotNot's APIs use Bearer token authentication. Send your account token as `Bearer `. You can find it in Settings > Account Settings > Developer. Keep it on your server: anyone who has it can call the API as your account. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.