---
title: "List Plaid bank connections"
method: GET
path: "/plaid/connections"
tags: ["Bank Feeds"]
---

# List Plaid bank connections

`GET /plaid/connections`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/plaid/connections`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns the organization's Plaid connections with per-account mapping and health state, plus the org's bank-feed entitlement. Access tokens are never returned.

## Response `200`

Connections and entitlement

- object
  - `connections` PlaidConnection[]
    - `id` string, uuid
    - `institutionId` string, nullable
    - `institutionName` string, nullable
    - `status` 'connected' | 'disconnected'
    - `healthStatus` 'healthy' | 'broken' | 'disconnected'
    - `healthError` string, nullable
    - `feedPausedAt` string, date-time, nullable
    - `disconnectScheduledAt` string, date-time, nullable
    - `lastSyncedAt` string, date-time, nullable
    - `newAccountsAvailableAt` string, date-time, nullable
    - `consentExpirationTime` string, date-time, nullable
    - `consentLastCheckedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `accounts` PlaidConnectedAccount[]
      - `id` string, uuid
      - `providerAccountId` string
      - `name` string, nullable
      - `officialName` string, nullable
      - `type` string, nullable
      - `subtype` string, nullable
      - `mask` string, nullable
      - `currentBalance` integer, nullable
      - `availableBalance` integer, nullable
      - `importEnabled` boolean
      - `bankAccountId` string, uuid, nullable
      - `mappedAt` string, date-time, nullable
      - `syncError` string, nullable
      - `lastSyncedAt` string, date-time, nullable
  - `entitlement` object
    - `configured` boolean
    - `plaidBankFeeds` boolean
    - `statementsEnabled` boolean

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)