---
title: "List scoped tools"
method: GET
path: "/api/v1/tools/scoped"
tags: ["Tool Calling"]
---

# List scoped tools

`GET /api/v1/tools/scoped`

Tools already bound to one connected-account identifier. Use this when you need the list a user or agent is authorized to call (the list you pass to an LLM). Filter by provider, tool name, or connection name. `identifier` is required.

## Query parameters

- `identifier` string, required
- `filter.providers` string[]
- `filter.tool_names` string[]
- `filter.connection_names` string[]
- `page_size` integer
- `page_token` string

## Response `200`

Paginated list of tools scoped to the given connected account identifier

- ToolsListScopedToolsResponse
  - `next_page_token` string — Token for fetching the next page of tools
  - `prev_page_token` string — Token for fetching the previous page of tools
  - `tools` ToolsScopedTool[] — List of tools scoped to the given connected account identifier
    - `connected_account_id` string — ID of the connected account for this scoped tool
    - `identifier` string — Connected account identifier this tool is scoped to
    - `tool` ToolsTool
      - `definition` object — Tool definition in structured format
      - `id` string — Unique ID of the tool. Immutable and read-only.
      - `is_default` boolean — Marks this tool as the default version for the combination. Read-only.
      - `metadata` object — Additional metadata about the tool
      - `provider` string — Provider name (e.g. GOOGLE). Read-only.
      - `tags` string[] — Tags for categorization or filtering
      - `updated_at` string, date-time — Timestamp when the tool was last updated. Read-only.
  - `total_size` integer — Total number of tools matching the query

## Other responses

- `400` — Invalid request - missing identifier or malformed filter/pagination parameters
- `401` — Authentication required - missing or invalid access token

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/revisions/a7181708713b/schema)