Check Report Errors

Guide to troubleshooting Check Report errors

CONSUMER_REPORT_EXPIRED

Common causes
  • The Check Report has expired as 24 hours have passed since its creation, so it is no longer retrievable.
Troubleshooting steps
1http code 400
2{
3 "error_type": "CONSUMER_REPORT_ERROR",
4 "error_code": "CONSUMER_REPORT_EXPIRED",
5 "error_message": "",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

DATA_UNAVAILABLE

Common causes
  • Plaid Check failed to retrieve data from the user's financial institutions to generate Check Report product data.
Troubleshooting steps
1http code 400
2{
3 "error_type": "CHECK_REPORT_ERROR",
4 "error_code": "DATA_UNAVAILABLE",
5 "error_message": "The Check Report you are trying to pull does not have sufficient transactions data to generate a report.",
6 "display_message": null,
7 "causes": [
8  {
9   "display_message": null,
10   "error_code": "ITEM_LOGIN_REQUIRED",
11   "error_message": "The login details of this item have changed (credentials, MFA, or required user action) and a user login is required to update this information. use Link's update mode to restore the item to a good state",
12   "error_type": "ITEM_ERROR",
13   "item_id": "pZ942ZA0npFEa0BgLCV9DAQv3Zq8ErIZhc81F"
14  }
15 ],
16 "request_id": "HNTDNrA8F1shFEW"
17}

PRODUCT_NOT_READY

Note that this error should not be confused with the PRODUCT_NOT_READY error of type ITEM_ERROR, which has different causes.

Common causes
  • /check_report/.../get was called before report generation completed.
Troubleshooting steps
1http code 400
2{
3 "error_type": "CONSUMER_REPORT_ERROR",
4 "error_code": "PRODUCT_NOT_READY",
5 "error_message": "The consumer report you are trying to pull is not ready. Please wait for a CHECK_REPORT_READY webhook to fetch data",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INSTITUTION_TRANSACTION_HISTORY_NOT_SUPPORTED

Common causes
  • The user's financial institution does not support the length of transaction history you require
Troubleshooting steps
1http code 400
2{
3 "error_type": "CHECK_REPORT_ERROR",
4 "error_code": "INSTITUTION_TRANSACTION_HISTORY_NOT_SUPPORTED",
5 "error_message": "The user’s bank does not support the transactions range you require. Lowering the days_required may result in success.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

INSUFFICIENT_TRANSACTION_DATA

Common causes
  • The user does not have sufficient transactions data to generate income insights, partner insights, or cashflow insights. The error_message will provide more detail on what data is missing.
Troubleshooting steps
1http code 400
2{
3 "error_type": "CHECK_REPORT_ERROR",
4 "error_code": "INSUFFICIENT_TRANSACTION_DATA",
5 "error_message": "",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

NO_ACCOUNTS

Common causes
  • The user does not the correct accounts linked to generate income insights. The error_message will provide more detail on what data is missing.
Troubleshooting steps
1http code 400
2{
3 "error_type": "CHECK_REPORT_ERROR",
4 "error_code": "NO_ACCOUNTS",
5 "error_message": "No depository accounts were found for this user",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

NETWORK_CONSENT_REQUIRED

Common causes
  • The user did not provide consent in link to share Plaid network data.
Troubleshooting steps
1http code 400
2{
3 "error_type": "CHECK_REPORT_ERROR",
4 "error_code": "NETWORK_CONSENT_REQUIRED",
5 "error_message": "User has not provided consent to share network data",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}