> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Integrations

> List connected integrations and their sync health

List the external systems connected to a company, with connection state, sync health, and the last sync error.

<Note>
  This endpoint is read-only and never returns credentials. Access tokens,
  refresh tokens, webhook secrets, and provider API keys are excluded. The
  `details` object carries only an allowlist of non-secret descriptive fields.
</Note>

## Request

<ParamField query="includeInactive" type="boolean" default="false">
  Include disconnected integrations. By default only active integrations are
  returned.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/integrations" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response fields

<ResponseField name="provider" type="string">
  Provider identifier, such as `stripe`, `shopify`, `supabase`, or `clerk`.
</ResponseField>

<ResponseField name="providerAccountId" type="string">
  Provider-side account identifier, such as a Shopify shop domain or a Stripe
  `acct_` ID.
</ResponseField>

<ResponseField name="syncStatus" type="string">
  Last known sync state, such as `idle`, `syncing`, or `error`.
</ResponseField>

<ResponseField name="lastSyncError" type="string">
  Error message from the most recent failed sync, or `null`.
</ResponseField>

<ResponseField name="details" type="object">
  Allowlisted non-secret metadata, such as `shopName`, `primaryDomain`, or
  `scopes`.
</ResponseField>

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "integrations": [
      {
        "id": "int_abc123",
        "provider": "shopify",
        "providerAccountId": "acme.myshopify.com",
        "isActive": true,
        "syncEnabled": true,
        "syncStatus": "idle",
        "lastSyncAt": "2026-05-01T10:30:00Z",
        "lastSyncError": null,
        "totalCustomersSynced": 4821,
        "totalEventsSynced": 19422,
        "connectedAt": "2026-01-14T08:12:00Z",
        "disconnectedAt": null,
        "details": { "shopName": "Acme", "primaryDomain": "acme.com" }
      }
    ]
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 403 theme={null}
  {
    "success": false,
    "error": "API key is missing required scope: account:read"
  }
  ```
</ResponseExample>