Skip to main content
Learn about the structure of pay data available in the /payouts and /income-totals endpoints. Argyle allows you to retrieve detailed income data for all connected payroll accounts.
  • The /payouts endpoint provides information from individual paystubs.
  • The /income-totals endpoint provides total pay amounts from all paystubs for each calendar year.

​
Payouts

The /payouts endpoint provides machine-readable, normalized versions of traditional paystubs. These digital paystubs are returned as payout objects.
  • Each payout object contains summary information, paystub totals, year-to-date amounts, information from each paystub entry, and gross pay totals by type.
Year-to-date amounts in the payout object are provided as they appear on paystubs. They are not calculated values.
  • A complete list of available information provided by the /payouts endpoint can be found in Payouts, including a full sample JSON object.

​
Structure of payout objects

Payouts include pay totals, year to date amounts, and gross pay totals by category from individual paystubs.

​
Structure of gross_pay_list, deduction_list, and tax_list

  • gross_pay_list, deduction_list, and tax_list contain information from individual entries on a paystub.
Structure of these arrays of objects.

​
Structure of gross_pay_list_totals

Paystub entries contained in gross_pay_list are added together based on their type attribute and presented in the gross_pay_list_totals object. Gross pay list totals are organized by type.

​
Income totals

The /income-totals endpoint provides total pay amounts gathered from all paystubs for each available calendar year. Information regarding users’ total yearly compensation is fundamental in many use cases, but paystubs often omit this information or provide it only for some but not all entries. Through the /income-totals endpoint, Argyle aggregates this yearly income information in a standardized way.

​
Structure of the /income-totals endpoint

Yearly pay information is returned as a series of objects representing each calendar year. Yearly totals are returned in objects that represent calendar years. A full sample JSON object can be found in Income Totals in our API Reference.

​
Connecting /payouts and /income-totals

  • income_totals.gross_pay corresponds to payout.gross_pay_list_totals.
  • income_totals.deductions is based on payout.deductions and payout.deductions_ytd, with income_totals.taxes and income_totals.net_pay following the same approach.
  • income_totals.reimbursements and income_totals.fees correspond to payout.reimbursements and payout.fees, respectively.