---
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 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/versions/64c4514ea59b/schema)