---
title: "List tools with schemas for a tool router session (v3.1)"
method: GET
path: "/api/v3.1/tool_router/session/{session_id}/tools"
tags: ["Tool Router"]
---

# List tools with schemas for a tool router session (v3.1)

`GET /api/v3.1/tool_router/session/{session_id}/tools`

Returns tools available in a tool router session with complete schemas. Results are paginated; use `next_cursor` to fetch the next page. Tools are returned in alphabetical order.

## Path parameters

- `session_id` string, toolRouterSessionId, required — Tool router session ID

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Successfully retrieved paginated tools with their complete schemas.

- 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
- `401` — Unauthorized
- `404` — Session not found
- `500` — Internal server error

---

[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)