---
title: "List integrations"
method: GET
path: "/integrations"
tags: ["Integrations"]
---

# List integrations

`GET /integrations`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/integrations`
- Auth: HTTP bearer

Returns available integrations with optional connection status for the workspace.

When `detail=true`, returns full integration metadata from Nango including available actions, endpoints, and whether the workspace has an active connection.

When `detail=false` (default), returns only connected integrations from the database.

## Query parameters

- `workspaceId` string, uuid, required: Workspace ID
- `limit` integer: Maximum number of integrations to return (1-100)
- `offset` integer: Number of integrations to skip for pagination
- `detail` boolean: Include detailed integration metadata

## Response `200`

Integrations list

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `integrations` union[], required
        - union
          - object
            - `unique_key` string
            - `display_name` string
            - `provider` string
            - `logo` string
            - `created_at` string
            - `updated_at` string
            - `connection` object, nullable
              - …
            - `config` object
              - …
            - `orphaned` boolean
          - object
            - `id` string, uuid, required
            - `workspaceId` string, uuid, required
            - `integrationType` string, required
            - `nangoConnectionId` string, required
            - `connectedAt` string, date-time, required
      - `total` integer, required
      - `limit` integer, required
      - `offset` integer, required

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)