Plaid logo
Docs
ALL DOCS

Errors

  • Overview
  • Item errors
  • Institution errors
  • API errors
  • Assets errors
  • Payment errors
  • Transfer errors
  • Income errors
  • Sandbox errors
  • Invalid Request errors
  • Invalid Input errors
  • Invalid Result errors
  • Rate Limit Exceeded errors
  • Link web errors
  • Recaptcha errors
  • OAuth errors
Plaid logo
Docs
Plaid.com
Get API keys

Income errors

Guide to troubleshooting Income errors

PRODUCT_NOT_ENABLED

The Income product has not been enabled.
Server-Side
Common causes
  • The Income product has not been enabled.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "PRODUCT_NOT_ENABLED",
5 "error_message": "the 'income_verification' product is not enabled for the following client ID: <CLIENT_ID>. please ensure that the 'income_verification' is included in the 'product' array when initializing Link and try again.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

INCOME_VERIFICATION_UPLOAD_ERROR

There was an error uploading income verification documents.
Server-SideorClient-Side
Common causes
  • The end user's Internet connection may have been interrupted during the upload attempt.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "INCOME_VERIFICATION_UPLOAD_ERROR",
5 "error_message": "there was a problem uploading the document for verification. Please try again or recreate an income verification.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

INCOME_VERIFICATION_FAILED

The income verification you are trying to retrieve could not be completed. please try creating a new income verification
Server-SideorClient-Side
Common causes
  • The processing of the verification failed to complete successfully.
Troubleshooting steps
1http code 500
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "INCOME_VERIFICATION_FAILED",
5 "error_message": "the income verification you are trying to retrieve could not be completed. please try creating a new income verification",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

VERIFICATION_STATUS_PENDING_APPROVAL

The user has not yet authorized the sharing of this data
Server-Side
Common causes
  • The user has not yet authorized access to the data.
Troubleshooting steps
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "VERIFICATION_STATUS_PENDING_APPROVAL",
5 "error_message": "The user has not yet authorized the sharing of this data",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?
Developer community
Github logo
StackOverflow logo
Twitter logo