---
title: "Find bots"
method: GET
path: "/bots"
tags: ["bots"]
---

# Find bots

`GET /bots`

## Query parameters

- `name` string
- `active` boolean
- `createdAt` string
- `updatedAt` string
- `limit` integer
- `offset` integer

## Response `200`

Success, returns all Bots

- BotResponse[]
  - `id` string — The UUID for the bot
  - `name` string — The unique readable name for the bot
  - `url` string — The URL of the bot server
  - `ui` object — The UI of the bot
    - `name` string — The name of the UI file.
    - `size` integer — The size of the UI file (bytes)
  - `active` boolean — Flag for if a bot is active with communication
  - `actions` object[] — A list of actions that a bot can perform
  - `data` object[] — A list of data that a bot can provide
  - `installedBy` string — The user who installed the bot

## Other responses

- `400` — Bad Request
- `401` — Authentication Error
- `404` — Resource Not Found
- `default` — Error

## Changes

- **2019-03-14** (v1) `61c43b67559b` — 2 info
  - added the new optional `query` request parameter `createdAt`
  - added the new optional `query` request parameter `updatedAt`
- **2018-03-30** (v1) `4ca6b20ef8df` — 2 warning
  - deleted the `query` request parameter `createdAt`
  - deleted the `query` request parameter `updatedAt`

[Change history](https://skmtc.dev/salesforce/apis/refocus-api/changes/bots/get.md)

---

[API](https://skmtc.dev/salesforce/apis/refocus-api.md) · [All operations](https://skmtc.dev/salesforce/apis/refocus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salesforce/refocus-api/revisions/42c2153b047e/schema)