Sample - Plaid API
POST/identity_verification/list

List Identity Verifications

Lists Identity Verification attempts created by your account, filtered by a required template and optional user identifiers. Use cursor to continue through additional pages of matching verifications. Each result includes the verification status, timestamps, configured template, user data, and available step results.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

6 body fields

Request defining the template and optional user and pagination filters for Identity Verification attempts.

secretstringoptional
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.
client_idstringoptional
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.
template_idstringrequired
ID of the associated Identity Verification template. Like all Plaid identifiers, this is case-sensitive.
client_user_idstringoptional
A unique ID that identifies the end user in your system. Either a `user_id` or the `client_user_id` must be provided. This ID can also be used to associate user-specific data from other Plaid products. Financial Account Matching requires this field and the `/link/token/create` `client_user_id` to be consistent. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`.
user_idobjectoptional
A unique user identifier, created by calling `/user/create`. Either a `user_id` or the `client_user_id` must be provided. The `user_id` may only be used instead of the `client_user_id` if you were not a pre-existing user of `/user/create` as of December 10, 2025, or if you have since [migrated to the new User APIs](https://plaid.com/docs/api/users/migrate-to-new-user-apis); for more details, see [New User APIs](https://plaid.com/docs/api/users/user-apis). If both this field and the `client_user_id` are present in the request, the `user_id` must have been created from the provided `client_user_id`.
cursorstringoptional
An identifier that determines which page of results you receive.

1 status code
200Returns an array of Identity Verification attempts matching the filters, a `next_cursor` for another page, and a unique `request_id`.
identity_verificationsarray<object>required
List of Plaid sessions
next_cursorstringrequired
An identifier that determines which page of results you receive.
request_idstringrequired
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

Error handling

template_id is required and must identify the template used to filter the verifications. If you provide cursor, it must be a pagination identifier from a previous response; client_user_id and user_id can further restrict the results.