> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tools

> Retrieve a paginated list of your tools. Returns tools that are not tied to a specific resource connection.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

**page** `integer`

Page number for pagination. Minimum `1`. Defaults to `1`.

**limit** `integer`

Number of results per page. Minimum `1`, maximum `1000`. Defaults to `50`.

**search** `string`

Filter results by searching the tool's `name` and `description` fields.

**orderBy** `string`

Field to sort results by. Currently only `"created_at"` is supported.

**orderDirection** `string`

Sort direction. Allowed values: `"asc"`, `"desc"`. Defaults to `"desc"`.

> [!NOTE]
>
> This endpoint only returns tools that are **not** tied to a specific resource connection (`resource_id: null`). Tools created as part of a connected integration resource are excluded.

### Response

**data.tools** `array`

Array of integration tool objects.

**tool object**

**id** `string`

Unique identifier for the tool (prefixed with `TL-`).

**name** `string`

The tool's name.

**description** `string`

The tool's description.

**integration** `string`

The integration key (e.g. `"slack"`).

**action** `string`

The action within the integration.

**input\_schema** `object`

JSON Schema for the tool's input parameters.

**speech** `string`

Text the AI says while using this tool.

**timeout** `number`

Timeout in milliseconds.

**cache** `boolean`

Whether response caching is enabled.

**max\_retries** `number`

Maximum retry attempts.

**cooldown** `number`

Seconds between retries.

**label** `string`

Human-readable label, if set.

**is\_active** `boolean`

Whether the tool is active and available for use.

**is\_draft** `boolean`

Whether the tool is in draft state.

**public** `boolean`

Whether the tool is publicly visible.

**created\_at** `string`

ISO 8601 timestamp of when the tool was created.

**data.pagination** `object`

Pagination metadata.

**pagination object**

**page** `number`

The current page number.

**limit** `number`

Number of results per page.

**hasMore** `boolean`

Whether there are additional pages of results.

**nextPage** `number | null`

The next page number, or `null` if there are no more pages.

**errors** `null|array`

`null` on success, or a list of error objects if the request failed.

```json Response (Success) theme={null}
{
  "data": {
    "tools": [
      {
        "id": "TL-abc123def456",
        "name": "SendSlackMessage",
        "description": "Sends a message to a Slack channel",
        "integration": "slack",
        "action": "send_message",
        "input_schema": {
          "type": "object",
          "properties": {
            "channel": { "type": "string" },
            "message": { "type": "string" }
          },
          "required": ["channel", "message"]
        },
        "speech": "Sending that message to Slack now.",
        "timeout": 10000,
        "cache": false,
        "max_retries": 0,
        "cooldown": null,
        "label": null,
        "is_active": true,
        "is_draft": false,
        "public": false,
        "created_at": "2025-09-23T15:13:36.348Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "hasMore": false,
      "nextPage": null
    }
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.