Plaid logo
Docs
ALL DOCS

Errors

  • Overview
  • Item errors
  • Institution errors
  • API errors
  • Assets errors
  • Payment errors
  • Transactions 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
  • Microdeposits errors
  • Partner errors
Plaid logo
Docs
Plaid.com
Get API keys
Open nav

Income errors

Guide to troubleshooting Income errors

INCOME_VERIFICATION_DOCUMENT_NOT_FOUND

The requested income verification document was not found.
Common causes
  • The document URL is incorrect (for example, it may contain a typo) or has expired.
  • The document URL has already been accessed. Document URLs can only be used once.
Troubleshooting steps
Copy
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "INCOME_VERIFICATION_DOCUMENT_NOT_FOUND",
5 "error_message": "the requested data was not found. Please check the ID supplied.",
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
Common causes
  • The processing of the verification failed to complete successfully.
Troubleshooting steps
Copy
1http code 400
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?

INCOME_VERIFICATION_NOT_FOUND

The requested income verification was not found.
Common causes
  • The Link flow has not been completed with income_verification enabled; either the user has not yet completed the Link flow, or the link token was not initialized with the income_verification product.
Troubleshooting steps
Copy
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "INCOME_VERIFICATION_NOT_FOUND",
5 "error_message": "the requested data was not found. Please check the ID supplied.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

INCOME_VERIFICATION_UPLOAD_ERROR

There was an error uploading income verification documents.
Common causes
  • The end user's Internet connection may have been interrupted during the upload attempt.
Troubleshooting steps
Copy
1http code 500
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?

PRODUCT_NOT_ENABLED

The Income product has not been enabled.
Common causes
  • The Income product has not been enabled.
Troubleshooting steps
Copy
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?

PRODUCT_NOT_READY

The Income product has not completed processing.
Common causes
  • Parsing of the uploaded pay stubs has not yet completed.
Troubleshooting steps
Copy
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "PRODUCT_NOT_READY",
5 "error_message": "the requested product is not yet ready. please provide a webhook or try the request again later",
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
Common causes
  • The user has not yet authorized access to the data.
Troubleshooting steps
Copy
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?

EMPLOYMENT_NOT_FOUND

The requested employment was not found.
Common causes
  • The Link flow has not been completed with employment enabled; either the user has not yet completed the Link flow, or the link token was not initialized with the employment product.
Troubleshooting steps
Copy
1http code 400
2{
3 "error_type": "INCOME_VERIFICATION_ERROR",
4 "error_code": "EMPLOYMENT_NOT_FOUND",
5 "error_message": "the requested employment data was not found. Please check the ID supplied.",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?
Developer community
GitHub
GitHub
Stack Overflow
Stack Overflow
YouTube
YouTube
Twitter
Twitter
Discord
Discord