Skip to main content
GET
/
v2
/
tools
List Tools
curl --request GET \
  --url https://api.bland.ai/v2/tools \
  --header 'authorization: <authorization>'
{
  "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
}

​
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".
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.
​
data.pagination
object
Pagination metadata.
​
errors
null|array
null on success, or a list of error objects if the request failed.
{
  "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
}