---
title: "List bank-feed recovery incidents"
method: GET
path: "/bank-feeds/incidents"
tags: ["Bank Feeds"]
---

# List bank-feed recovery incidents

`GET /bank-feeds/incidents`

## Request

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

Read-only connection and delivery incident projection. Firm members see only accessible companies; companyOrganizationId may narrow that scope. REST twin of list_bank_feed_incidents.

## Query parameters

- `companyOrganizationId` string, uuid
- `status` 'open' | 'resolved'
- `cursor` string
- `limit` integer

## Response `200`

Recovery incidents and keyset cursor

- object
  - `incidents` object[], required
    - `id` string, uuid, required
    - `organizationId` string, uuid, required
    - `firmOrganizationId` string, uuid, nullable
    - `companyName` string, nullable
    - `plaidItemId` string, uuid, nullable
    - `kind` 'reconnect' | 'connect'
    - `institutionName` string, nullable
    - `accountLabels` string[], nullable
    - `errorCode` string, nullable
    - `status` 'open' | 'resolved', required
    - `domain` 'connection' | 'delivery', required
    - `recoveryState` 'client_action_required' | 'outreach_active' | 'bounded_resync' | 'recovery_pending' | 'statement_evidence_needed' | 'firm_review' | 'recovered', required
    - `connectionHealthStatus` 'healthy' | 'broken' | 'disconnected' | 'null', nullable
    - `deliveryHealthStatus` string, nullable
    - `clientActionRequired` boolean, required
    - `outreachState` string, required
    - `nextAction` string, required
    - `reminderCount` integer, required
    - `nextReminderAt` string, date-time, nullable
    - `firstDetectedAt` string, date-time, required
    - `lastDetectedAt` string, date-time, required
    - `recoveryPendingSince` string, date-time, nullable
    - `verifiedDeliveryAt` string, date-time, nullable
    - `outreachStoppedAt` string, date-time, nullable
    - `lastTextSentAt` string, date-time, nullable
    - `resolvedAt` string, date-time, nullable
    - `resolutionReason` string, nullable
    - `evidenceRequestId` string, uuid, nullable
  - `nextCursor` string, nullable, required
  - `hasMore` boolean, required

## 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)