---
title: "List connected accounts"
method: GET
path: "/v1/integrations/installations"
tags: ["integrations"]
---

# List connected accounts

`GET /v1/integrations/installations`

List every account connected through Gmail, Google Drive, Slack, or Granola, with the store each feeds.

Each entry has the same shape as [Get Installation](#operation/get_integration_installation).

## Query parameters

- `limit` integer — Maximum number of items to return per page (1-100)
- `after` string, nullable — Cursor for forward pagination - get items after this position. Use last_cursor from previous response.
- `before` string, nullable — Cursor for backward pagination - get items before this position. Use first_cursor from previous response.
- `include_total` boolean — Whether to include total count in response (expensive operation)
- `provider` 'google_drive' | 'gmail' | 'slack' | 'granola', nullable — Only accounts connected through this connector

## Response `200`

Connected accounts across connectors, newest first

- ConnectorInstallationListResponse — One page of connected accounts.
  - `data` ConnectorInstallation[], required — Connected accounts, newest first
    - `installation_id` string, required — Installation ID
    - `provider` 'google_drive' | 'gmail' | 'slack' | 'granola', required — Connector provider
    - `status` string, required — Installation status
    - `account` ConnectorAccount, required — The third-party account an installation is authorized as.
      - `id` string, required — Provider-side account identifier (email, user ID, or team ID)
      - `name` string, nullable — Human-readable account name
      - `email` string, nullable — Account email, when the provider exposes one
      - `workspace` string, nullable — Workspace or organization the account belongs to, for providers that have one
    - `store_id` string, nullable — Store the installation ingests into
    - `store_name` string, nullable — Name of that store
    - `sync` ConnectorInstallationSync — Account-level sync facts: how many resources are in error, and the last failure of an account-wide job.
      - `failed_resource_count` integer — Resources whose last sync job failed
      - `last_error` string, nullable — Last failure of a job covering the whole account, such as a changes sync
      - `last_error_operation` string, nullable — Which account-wide job failed
      - `last_error_at` string, date-time, nullable — When it failed
  - `pagination` CursorPaginationResponse, required — Response model for cursor-based pagination.
    - `has_more` boolean, required — Contextual direction-aware flag: True if more items exist in the requested pagination direction. For 'after': more items after this page. For 'before': more items before this page.
    - `first_cursor` string, nullable, required — Cursor of the first item in this page. Use for backward pagination. None if page is empty.
    - `last_cursor` string, nullable, required — Cursor of the last item in this page. Use for forward pagination. None if page is empty.
    - `total` integer, nullable — Total number of items available across all pages. Only included when include_total=true was requested. Expensive operation - use sparingly.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-08** `ce403656bc18` — 9 breaking, 4 warning, 6 info
  - removed the required property `data/items/created_at` from the response with the `200` status
  - removed the required property `data/items/external_account_id` from the response with the `200` status
  - removed the required property `data/items/external_account_name` from the response with the `200` status
  - removed the required property `data/items/id` from the response with the `200` status
  - …15 more

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/integrations/installations/get.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/9c6c72afde2d?raw)