---
title: "List Integrations"
method: GET
path: "/tools/catalog/providers/{provider_key}/integrations/"
tags: ["Tools"]
---

# List Integrations

`GET /tools/catalog/providers/{provider_key}/integrations/`

## Path parameters

- `provider_key` string, required

## Query parameters

- `search` string, nullable
- `sort_by` string, nullable
- `category` string, nullable
- `limit` integer, nullable
- `cursor` string, nullable
- `full_details` boolean

## Response `200`

Successful Response

- ToolCatalogIntegrationsResponse
  - `count` integer
  - `total` integer
  - `cursor` string, nullable
  - `integrations` union[]
    - union
      - ToolCatalogIntegration
        - `key` string, required
        - `name` string, required
        - `description` string, nullable
        - `categories` string[]
        - `logo` string, nullable
        - `url` string, nullable
        - `actions_count` integer, nullable
        - `auth_schemes` ToolAuthScheme[], nullable
      - ToolCatalogIntegrationDetails
        - `key` string, required
        - `name` string, required
        - `description` string, nullable
        - `categories` string[]
        - `logo` string, nullable
        - `url` string, nullable
        - `actions_count` integer, nullable
        - `auth_schemes` ToolAuthScheme[], nullable
        - `actions` ToolCatalogAction[], nullable
          - `key` string, required
          - `name` string, required
          - `description` string, nullable
          - `categories` string[]
          - `logo` string, nullable
          - `read_only` boolean, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-25** `5a14788d939f` — 2 info
  - added the new optional `query` request parameter `category`
  - added the optional property `integrations/items/anyOf[subschema #2: ToolCatalogIntegrationDetails]/actions/anyOf[subschema #1]/items/read_only` to the response with the `200` status
- **2026-04-18** `c469c2f6cdba` — 1 info
  - endpoint added
- **2025-06-27** `e3e84db47198` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/tools/catalog/providers/:provider_key/integrations/get.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/713e4f3b7519/schema)