---
title: "Bank feed connection and delivery health"
method: GET
path: "/bank-feeds/health"
tags: ["Bank Feeds"]
---

# Bank feed connection and delivery health

`GET /bank-feeds/health`

## Request

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

Shared REST/MCP health contract for connection state, delivery state, sync evidence, active recovery incidents, and mapped accounts. fresh means the last successful sync is under 24 hours old. Compatibility healthStatus/healthError aliases equal the connection-health fields.

## Response `200`

Feed health

- object
  - `connections` object[]
    - `id` string, uuid
    - `institutionName` string, nullable
    - `status` string
    - `connectionHealthStatus` 'healthy' | 'broken' | 'disconnected'
    - `connectionHealthError` string, nullable
    - `healthStatus` string
    - `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
    - `fresh` boolean
    - `deliveryHealthStatus` 'unknown' | 'delivering' | 'quiet' | 'silent' | 'stale' | 'recovery_pending' | 'statement_evidence_needed'
    - `deliveryHealthCheckedAt` string, date-time, nullable
    - `deliveryLastEventAt` string, date-time, nullable
    - `deliveryResyncCount` integer
    - `deliveryNextCheckAt` string, date-time, nullable
    - `activeIncidentId` string, uuid, nullable
    - `activeIncidentDomain` 'connection' | 'delivery' | 'null', nullable
    - `activeIncidentRecoveryState` 'client_action_required' | 'outreach_active' | 'bounded_resync' | 'recovery_pending' | 'statement_evidence_needed' | 'firm_review' | 'recovered' | 'null', nullable
    - `accounts` object[]
      - `id` string, uuid
      - `plaidItemId` string, uuid
      - `providerAccountId` string
      - `name` string, nullable
      - `officialName` string, nullable
      - `type` string, nullable
      - `subtype` string, nullable
      - `mask` string, nullable
      - `importEnabled` boolean
      - `bankAccountId` string, uuid, nullable
      - `bankAccountName` string, nullable
      - `syncError` string, nullable
      - `lastSyncedAt` string, date-time, nullable
      - `fresh` 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)