---
title: "GET /bots/"
method: GET
path: "/bots/"
---

# GET /bots/

`GET /bots/`

Returns bot information as follows:

*   If you provide the `nameContains` field, the response includes information for the `$LATEST` version of all bots whose name contains the specified string.
    
*   If you don't specify the `nameContains` field, the operation returns information about the `$LATEST` version of all of your bots.
    

This operation requires permission for the `lex:GetBots` action.

## Query parameters

- `nextToken` string
- `maxResults` integer
- `nameContains` string

## Response `200`

Success

- GetBotsResponse
  - `bots` BotMetadata[] — An array of <code>botMetadata</code> objects, with one entry for each bot.
    - `name` string — The name of the bot.
    - `description` string — A description of the bot.
    - `status` 'BUILDING' | 'READY' | 'READY_BASIC_TESTING' | 'FAILED' | 'NOT_BUILT' — The status of the bot.
    - `lastUpdatedDate` string, date-time — The date that the bot was updated. When you create a bot, the creation date and last updated date are the same.
    - `createdDate` string, date-time — The date that the bot was created.
    - `version` string — The version of the bot. For a new bot, the version is always <code>$LATEST</code>.
  - `nextToken` string — If the response is truncated, it includes a pagination token that you can specify in your next request to fetch the next page of bots.

## Other responses

- `480` — NotFoundException
- `481` — LimitExceededException
- `482` — InternalFailureException
- `483` — BadRequestException

---

[API](https://skmtc.net/aws/apis/lex-models.md) · [All operations](https://skmtc.net/aws/apis/lex-models/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/lex-models/revisions/7b110b0aa60e/schema)