---
title: "Search for an Issue"
method: POST
path: "/issues/search"
tags: ["plaid"]
---

# Search for an Issue

`POST /issues/search`

Search for an issue associated with one of the following identifiers:  `item_id`, `link_session_id` or Link session `request_id`.
This endpoint returns a list of `Issue` objects, with an empty list indicating that no issues are associated with the
provided identifier. At least one of the identifiers must be provided to perform the search.

## Request body

- IssuesSearchRequest — IssuesSearchRequest defines the request schema for `/issues/search`.
  - `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.
  - `item_id` string — A unique identifier for the Plaid Item.
  - `link_session_id` string — A unique identifier for the Link session.
  - `link_session_request_id` string — The `request_id` for the Link session that might have had an institution connection issue.

## Response `200`

OK

- IssuesSearchResponse — IssuesSearchResponse defines the response schema for `/issues/search`.
  - `issues` Issue[] — A list of issues affecting the Item, session, or request passed in, conforming to the Issues data model. An empty list indicates that no matching issues were found.
    - `issue_id` string — The unique identifier of the issue.
    - `institution_names` string[] — A list of names of the financial institutions affected.
    - `institution_ids` string[] — A list of ids of the financial institutions affected.
    - `created_at` string, date-time — The creation time of the record tracking this issue.
    - `summary` string — A simple summary of the error for the end user.
    - `detailed_description` string — A more detailed description for the customer.
    - `status` 'REPORTED' | 'AWAITING_RESOLUTION' | 'FIX_IN_PROGRESS' | 'FIX_PENDING_VALIDATION' | 'CANNOT_FIX' | 'RESOLVED' — The current status of the issue.
  - `request_id` string — A unique identifier for the API request.

## Other responses

- `default` — Error response

## Changes

- **2025-03-26** `09cbc8444913` — 2 warning
  - added the new `CHECK_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `CONSUMER_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
- **2024-10-09** `36052f62cce1` — 1 info
  - endpoint added
- **2024-02-21** `5de70cc1e6ca` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/issues/search/post.md)

---

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