---
title: "List available tools"
method: GET
path: "/api/v3.1/tools"
tags: ["Tools"]
---

# List available tools

`GET /api/v3.1/tools`

Retrieve a paginated list of available tools with comprehensive filtering, sorting and search capabilities. Use query parameters to narrow down results by toolkit, tags, or search terms.

## Query parameters

- `toolkit_slug` string
- `tool_slugs` string
- `auth_config_ids` union
  - string
  - string[]
- `important` 'true' | 'false'
- `tags` string[]
- `scopes` string[], nullable — Filter tools by one or more scopes (can be specified multiple times)
- `query` string
- `search` string
- `include_deprecated` boolean
- `toolkit_versions` union
  - string
  - object — Object representation of parsed bracket notation
- `limit` number, nullable
- `cursor` string

## Response `200`

Successfully retrieved tools list with pagination information

- ToolsPaginated
  - `items` Tool[], required
    - `slug` string, required — Unique identifier for the tool
    - `name` string, required — Human-readable display name of the tool
    - `description` string, required — Detailed explanation of the tool's functionality and purpose
    - `toolkit` object, required
      - `slug` string, required — Unique identifier of the parent toolkit
      - `name` string, required — Human-readable name of the parent toolkit
      - `logo` string, required — URL to the toolkit logo image
    - `input_parameters` object, required — Schema definition of required input parameters for the tool
    - `no_auth` boolean, required — Indicates if the tool can be used without authentication
    - `available_versions` string[], required — List of all available versions for this tool
    - `version` string, required — Current version of the tool
    - `output_parameters` object, required — Schema definition of return values from the tool
    - `scopes` string[], required — List of scopes associated with the tool
    - `scope_requirements` object, nullable, required — Structured scope requirements for the tool. Null means the tool is legacy and only exposes flat scopes.
      - `all_of` union[], required
        - union
          - string
          - object
            - `any_of` union[], required
              - …
            - `when` object
            - `source` string[]
      - `source` string[]
    - `tags` string[], required — List of tags associated with the tool for categorization and filtering
    - `human_description` string — Human-friendly description of the tool, if available
    - `is_deprecated` boolean, required — Indicates if this tool is deprecated and may be removed in the future
    - `deprecated` object, required
      - `displayName` string, required — The display name of the tool
      - `version` string, required — Current version identifier of the tool
      - `available_versions` string[], required — List of all available versions for this tool
      - `is_deprecated` boolean, required — Indicates if this tool is deprecated and may be removed in the future
      - `toolkit` object, required
        - `logo` string, required — URL to the toolkit logo image
  - `next_cursor` string, nullable
  - `total_pages` number, required
  - `current_page` number, required
  - `total_items` number, required

## Other responses

- `400` — Bad request - Invalid query parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - User does not have permission to access tools
- `404` — Not found - The requested resource was not found
- `429` — Too many requests - Rate limit exceeded
- `500` — Internal server error - Something went wrong on the server

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)