---
title: "List institution issues"
method: POST
path: "/beta/issues/v1/list"
tags: ["plaid"]
---

# List institution issues

`POST /beta/issues/v1/list`

Retrieve high-severity issues for an institution.

## Request body

- BetaIssuesV1ListRequest — BetaIssuesV1ListRequest defines the request schema for `/beta/issues/v1/list`.
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `institution_id` string, required — The identifier of the institution whose issues should be returned.

## Response `200`

OK

- BetaIssuesV1ListResponse — BetaIssuesV1ListResponse defines the response schema for `/beta/issues/v1/list`.
  - `issues` BetaIssuesV1Issue[], required — Critical and high-severity issues that are active or were resolved in the past 14 days. An empty list indicates that no matching issues were found.
    - `issue_id` string, required — The customer-visible identifier of the issue.
    - `issue_type` 'ERROR', required — The customer-facing category of an issue.
    - `severity` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW', required — The customer-facing severity of an issue.
    - `institution_id` string, required — The identifier of the institution affected by the issue.
    - `institution_name` string, required — The name of the institution affected by the issue.
    - `behaviors` BetaIssuesV1IssueBehavior[], required — The customer-visible effects of the issue.
    - `issue_error_type` string, nullable, required — The API error type associated with the issue if available. Mirrors the `error_type` field on `PlaidError` returned on error responses and is safe for programmatic use. Always null or non-null together with `issue_error_code`.
    - `issue_error_code` string, nullable, required — The API error code associated with the issue if available. Always null or non-null together with `issue_error_type`.
    - `description` string, required — A customer-facing explanation of the issue.
    - `attribution` 'USER' | 'PLAID' | 'DATA_PARTNER', required — The party responsible for resolving an issue.
    - `status` 'USER_ACTION_REQUIRED' | 'BACKLOGGED' | 'LIKELY_TO_BE_PRIORITIZED' | 'IN_PROGRESS' | 'RESOLVED' | 'PENDING_NOTIFICATION' | 'DATA_PARTNER_NOTIFIED' | 'DATA_PARTNER_FIX_IN_PROGRESS', required — The customer-facing resolution state of an issue.
    - `user_guidance` string, nullable, required — Guidance for an end user affected by the issue, or null when no guidance is available.
    - `estimated_resolution_time` string, date-time, nullable, required — The estimated resolution time, or null when no estimate is available.
    - `start_time` string, date-time, nullable, required — The time the issue began, or null when it is unknown. Only populated for incidents.
    - `end_time` string, date-time, nullable, required — The time the issue ended, or null while it remains active.
    - `impact` BetaIssuesV1IssueImpact, nullable, required — The client-specific impact of an error issue.
      - `affected_new_item_count` integer, required
      - `affected_existing_item_count` integer, required
    - `affected_products` Products[], required — The Plaid products affected by the issue.
    - `resolution_log` BetaIssuesV1IssueResolutionEvent[], required — Resolution events recorded for the issue.
      - `resolution_time` string, date-time, required
      - `type` 'MANUAL_RESOLUTION' | 'AUTOMATED_RESOLUTION', required — How an issue was considered resolved. `MANUAL_RESOLUTION` indicates Plaid's engineering team has reviewed the issue and mitigated its impact. Issues that are manually resolved may still have a small number of occurrences. `AUTOMATED_RESOLUTION` indicates the error has not recently occurred and was automatically closed.
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/revisions/e536704a333f/schema)