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.
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
While in beta, Income is subject to the following limitations:
- Use of Income requires acceptance into the beta program. To request access to Income, contact your Plaid Account Manager.
- Information provided by income verification endpoints cannot be used to make underwriting decisions, it can only be used to verify information that an end user has provided.
- Income is not supported by Plaid's mobile SDKs, only by web and WebView-based implementations.
- Client libraries are not yet available for Income.
- Like all Plaid beta APIs, the Income API is subject to change without notice. Consult your Plaid Account Manager before using a beta API in production.