Retrieve Payroll Income

POST https://{{env_url}}/credit/payroll_income/get

Request Body

{"client_id"=>"{{client_id}}", "secret"=>"{{secret_key}}", "user_token"=>"{{user_token}}"}

RESPONSES

status: OK

{"items":[{"item_id":"WdJvAEWZd5tqR5wVKpjrtDZ41Nxdr1flwl4rK","payroll_income":[{"account_id":"DMoAG3kWM5T3Z5QzrGy8CBMDrrbWPNfnkWD6l","pay_stubs":[{"deductions":{"breakdown":[{"current_amount":1000,"description":"taxes","iso_currency_code":"USD","unofficial_currency_code":null,"ytd_amount":1234}],"total":{"current_amount":1000,"iso_currency_code":"USD","unofficial_currency_code":null,"ytd_amount":1234}},"document_id":"QVYKRjz2Nj","document_metadata":{"document_type":"PAYSTUB","download_url":"https://sandbox.plaid.com/income/verification/document/download/b1477df2-1372-492f-ac19-a5a8d0d5c547","name":"603b6fc3-27b0-48c0-add0-57a5886036c5.pdf","status":"DOCUMENT_STATUS_PROCESSING_COMPLETE"},"earnings":{"breakdown":[{"canonical_description":"REGULAR_PAY","current_amount":1006,"description":"salary earned","hours":40,"iso_currency_code":"USD","rate":25.15,"unofficial_currency_code":null,"ytd_amount":1006},{"canonical_description":"BONUS","current_amount":1000,"description":"bonus earned","hours":0,"iso_currency_code":"USD","rate":0,"unofficial_currency_code":null,"ytd_amount":1000},{"canonical_description":"OVERTIME","current_amount":320,"description":"overtime pay earned","hours":10,"iso_currency_code":"USD","rate":32,"unofficial_currency_code":null,"ytd_amount":320}],"total":{"current_amount":2306,"hours":50,"iso_currency_code":"USD","unofficial_currency_code":null,"ytd_amount":2306}},"employee":{"address":{"city":"Oakland","country":"US","postal_code":"94103","region":"CA","street":"1234 Grand Ave"},"marital_status":"SINGLE","name":"Josie Georgia Harrison","taxpayer_id":{"id_mask":"9020","id_type":"SSN"}},"employer":{"address":{"city":"San Francisco","country":"US","postal_code":"94103","region":"CA","street":"1098 Main Street"},"name":"Platypus LLC"},"net_pay":{"current_amount":1000,"description":"net pay","iso_currency_code":"USD","unofficial_currency_code":null,"ytd_amount":1234},"pay_period_details":{"distribution_breakdown":null,"end_date":"2022-04-06","gross_earnings":2306,"iso_currency_code":"USD","pay_amount":1000,"pay_date":"2022-04-07","pay_frequency":"BIWEEKLY","start_date":"2022-03-23","unofficial_currency_code":null},"verification":{"verification_attributes":null,"verification_status":"UNKNOWN"}},{"deductions":{"breakdown":[{"current_amount":1000,"description":"taxes","iso_currency_code":"USD","unofficial_currency_code":null,"ytd_amount":1234}],"total":{"current_amount":1000,"iso_currency_code":"USD","unofficial_currency_code":null,"ytd_amount":1234}},"document_id":"jnYrqlM2w3","document_metadata":{"document_type":"PAYSTUB","download_url":"https://sandbox.plaid.com/income/verification/document/download/c88d8753-7d1f-437d-83fd-f446d53a7957","name":"3653b6d4-7b49-465a-b6df-40bade95b9fb.pdf","status":"DOCUMENT_STATUS_PROCESSING_COMPLETE"},"earnings":{"breakdown":[{"canonical_description":"REGULAR_PAY","current_amount":1006,"description":"salary earned","hours":40,"iso_currency_code":"USD","rate":25.15,"unofficial_currency_code":null,"ytd_amount":1006},{"canonical_description":"BONUS","current_amount":1000,"description":"bonus earned","hours":0,"iso_currency_code":"USD","rate":0,"unofficial_currency_code":null,"ytd_amount":1000},{"canonical_description":"OVERTIME","current_amount":320,"description":"overtime pay earned","hours":10,"iso_currency_code":"USD","rate":32,"unofficial_currency_code":null,"ytd_amount":320}],"total":{"current_amount":2306,"hours":50,"iso_currency_code":"USD","unofficial_currency_code":null,"ytd_amount":2306}},"employee":{"address":{"city":"Oakland","country":"US","postal_code":"94103","region":"CA","street":"1234 Grand Ave"},"marital_status":"SINGLE","name":"Josie Georgia Harrison","taxpayer_id":{"id_mask":"9020","id_type":"SSN"}},"employer":{"address":{"city":"San Francisco","country":"US","postal_code":"94103","region":"CA","street":"1098 Main Street"},"name":"Platypus LLC"},"net_pay":{"current_amount":1000,"description":"net pay","iso_currency_code":"USD","unofficial_currency_code":null,"ytd_amount":1234},"pay_period_details":{"distribution_breakdown":null,"end_date":"2022-03-07","gross_earnings":2306,"iso_currency_code":"USD","pay_amount":1000,"pay_date":"2022-03-08","pay_frequency":"BIWEEKLY","start_date":"2022-02-21","unofficial_currency_code":null},"verification":{"verification_attributes":null,"verification_status":"UNKNOWN"}}],"w2s":[{"allocated_tips":"1000","box_12":[{"amount":"200","code":"A"}],"box_9":"box9","dependent_care_benefits":"1000","document_id":"1XOzJdPONE","document_metadata":{"document_type":"US_TAX_W2","download_url":"https://sandbox.plaid.com/income/verification/document/download/52afb553-86f3-4306-9314-d073a7d4fec9","name":"a781d158-589e-4b8b-a617-63fc9aa11dd6.pdf","status":"DOCUMENT_STATUS_PROCESSING_COMPLETE"},"employee":{"address":{"city":"Oakland","country":"US","postal_code":"94103","region":"CA","street":"1234 Grand Ave"},"marital_status":null,"name":"Josie Georgia Harrison","taxpayer_id":{"id_mask":null,"id_type":null}},"employer":{"address":{"city":"San Francisco","country":"US","postal_code":"94103","region":"CA","street":"1098 Main Street"},"name":"Platypus LLC"},"employer_id_number":"12-1234567","federal_income_tax_withheld":"1000","medicare_tax_withheld":"1000","medicare_wages_and_tips":"1000","nonqualified_plans":"1000","other":"other","retirement_plan":"CHECKED","social_security_tax_withheld":"1000","social_security_tips":"1000","social_security_wages":"1000","state_and_local_wages":[{"employer_state_id_number":"11111111111AAA","local_income_tax":"200","local_wages_tips":"200","locality_name":"local","state":"CA","state_income_tax":"200","state_wages_tips":"200"}],"statutory_employee":"CHECKED","tax_year":"2021","third_party_sick_pay":"CHECKED","wages_tips_other_comp":"1000"}]}]}],"request_id":"FpUjNNsGIcILsbT"}