List Installations

GET/v1/integrations/installations

Authorization

Authorizationstringrequired

Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`

Query Parameters

limitintegerdefault: 20

Maximum number of items to return per page (1-100)

Constraints

•Minimum: 1•Maximum: 100

afterstring

Cursor for forward pagination - get items after this position. Use last_cursor from previous response.

beforestring

Cursor for backward pagination - get items before this position. Use first_cursor from previous response.

include_totalbooleandefault: false

Whether to include total count in response (expensive operation)

providerenum

Only accounts connected through this connector

Possible values

google_drivegmailslackgranola

Response Body

Request

cURL

GET/v1/integrations/installations

curl 'https://api.mixedbread.com/v1/integrations/installations?limit=20&provider=gmail' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

JSON

{
  "data": [
    {
      "installation_id": "2f1c9a8e-6b4d-4e3a-9c1f-7d8e5b6a4c21",
      "provider": "gmail",
      "status": "active",
      "account": {
        "id": "olivia@example.com",
        "name": "olivia@example.com",
        "email": "olivia@example.com",
        "workspace": null
      },
      "store_id": "5d3e7f9a-1b2c-4d6e-8f0a-9c8b7a6d5e4f",
      "store_name": "mail-olivia",
      "sync": {
        "failed_resource_count": 0,
        "last_error": null,
        "last_error_operation": null,
        "last_error_at": null
      }
    },
    {
      "installation_id": "8a1d2c3b-4e5f-4a6b-9c7d-0e1f2a3b4c5d",
      "provider": "gmail",
      "status": "needs_reauth",
      "account": {
        "id": "sam@example.com",
        "name": "sam@example.com",
        "email": "sam@example.com",
        "workspace": null
      },
      "store_id": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "store_name": "mail-sam",
      "sync": {
        "failed_resource_count": 0,
        "last_error": "Google refused the refresh token: consent must be granted again",
        "last_error_operation": "gmail.history",
        "last_error_at": "2026-09-06T08:12:41.201000+00:00"
      }
    }
  ],
  "pagination": {
    "has_more": false,
    "first_cursor": "eyJpZCI6…",
    "last_cursor": "eyJpZCI6…",
    "total": null
  }
}