Assets errors

Guide to troubleshooting Assets errors

PRODUCT_NOT_ENABLED

Common causes

One or more of the Items in the Asset Report was not initialized with the Assets product. Unlike some products, Assets cannot be initialized "on-the-fly" via the API; they must be initialized through Link, either during the initial Link flow or by adding Assets to an existing Item via update mode.
The Assets product was deauthorized for one or more Items in the Asset Report — for example, if the user began an update mode session to add Assets but did not complete it.

Troubleshooting steps

Make sure to include assets in the list of products to initialize the Item for during Link, then have your user re-link the Item.

API error response

http code 400
{
 "error_type": "ASSET_REPORT_ERROR",
 "error_code": "PRODUCT_NOT_ENABLED",
 "error_message": "",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}

DATA_UNAVAILABLE

Common causes

One or more of the Items in the Asset Report has experienced an error.

Troubleshooting steps

Check the causes field for a detailed breakdown of errors, then follow the troubleshooting steps for any errors found.

If the causes field is not present, use /item/get to query the Items in the Asset Report for errors, then follow the troubleshooting steps for any errors found.

API error response

http code 400
{
 "error_type": "ASSET_REPORT_ERROR",
 "error_code": "DATA_UNAVAILABLE",
 "error_message": "unable to pull sufficient data for all items to generate this report. please see the \"causes\" field for more details",
 "display_message": null,
 "causes": [
  {
   "display_message": null,
   "error_code": "ITEM_LOGIN_REQUIRED",
   "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",
   "error_type": "ITEM_ERROR",
   "item_id": "pZ942ZA0npFEa0BgLCV9DAQv3Zq8ErIZhc81F"
  }
 ],
 "request_id": "HNTDNrA8F1shFEW"
}

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

/asset_report/get or /asset_report/pdf/get was called before the Asset Report generation completed.

Troubleshooting steps

Listen for the PRODUCT_READY webhook and wait to call /asset_report/get or /asset_report/pdf/get until that webhook has been fired.

API error response

http code 400
{
 "error_type": "ASSET_REPORT_ERROR",
 "error_code": "PRODUCT_NOT_READY",
 "error_message": "",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}

ASSET_REPORT_GENERATION_FAILED

Common causes

Plaid is experiencing temporary difficulties generating Asset Reports.
The Asset Report was too large to generate.

Troubleshooting steps

Check the error_message field for details on the cause of the error.

If the error_message indicates the Asset Report was too large, try requesting a shorter date range in the Asset Report.

Try creating the Asset Report again later.

If the error persists, please submit a Support ticket.

API error response

http code 400
{
 "error_type": "ASSET_REPORT_ERROR",
 "error_code": "ASSET_REPORT_GENERATION_FAILED",
 "error_message": "",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}

INVALID_PARENT

Common causes

An endpoint that creates a copy or modified copy of an Asset Report (such as /asset_report/filter or /asset_report/audit_copy/create) was called, but the original Asset Report does not exist, either because it was never successfully created, failed to generate, or was deleted.
The original Asset Report is still being generated.

Troubleshooting steps

Re-create the original Asset Report and re-try the endpoint call on the new Asset Report.

API error response

http code 400
{
 "error_type": "ASSET_REPORT_ERROR",
 "error_code": "INVALID_PARENT",
 "error_message": "",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}

INSIGHTS_PREVIOUSLY_NOT_ENABLED

Common causes

/asset_report/get was called with include_insights set to true by a Plaid developer account that is currently enabled for Asset Reports with Insights, but was not enabled at the time that the report was created.

Re-create the Asset Report with /asset_report/create and then fetch the new Asset Report.

API error response

http code 400
{
 "error_type": "ASSET_REPORT_ERROR",
 "error_code": "INSIGHTS_PREVIOUSLY_NOT_ENABLED",
 "error_message": "",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}

DATA_QUALITY_CHECK_FAILED

Common causes

The extracted data from the financial institution showed signs of poor data quality, preventing the generation of an accurate report.

Try creating the Asset Report again 1-2 days later.

API error response

http code 400
{
 "error_type": "ASSET_REPORT_ERROR",
 "error_code": "DATA_QUALITY_CHECK_FAILED",
 "error_message": "",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}