Introduction to Income (beta)
Verify income and paystubs with Income Verification (beta).
View Income requests, responses, and example code
View Income error codes and troubleshooting guides
Income (beta, US only) allows you to verify a user's income automatically based on paystubs they provide.
Verification of income flow
/income/verification/create, which returns the
income_verification_idused to initialize and identify your Income Verification instance. You will need to provide your client ID and secret, as well as a webhook endpoint.
- Provide the
income_verification_idfrom the previous step to
/link/token/createto create a
- On the client side, use the
link_tokento initialize Link.
- Your end user will be presented with the Plaid Link interface, where they can upload their paystub to verify income:
- After the user has uploaded their income verification materials, they will be automatically parsed, a process that typically takes several minutes. Once this process is complete, Plaid will send a webhook
INCOME: verification_statusto the webhook endpoint specified in Step 1.
- After receiving the
INCOME: verification_statuswebhook, you can use the endpoints
/income/verification/paystubs/getto programmatically access the user's income and paystub information, such as income received YTD, pay period details, and the income amount before and after tax indicated on the paystub. You can also retrieve a copy of the original uploaded paystub by calling