> ## Documentation Index > Fetch the complete documentation index at: https://docs.truv.com/llms.txt > Use this file to discover all available pages before exploring further. # The Pay Statements object > View information from pay statements such as dates, gross pay, net pay, and earnings with deductions. The pay statement endpoints return a list of pay statements with attribute object breakdowns. The statement is related to the `link_id` from Truv's Income and Employment API. ## Attributes The table below covers the values for pay statements. | Attribute | Type | Description | | :-------------------- | :--------------- | :--------------------------------------------------------------------------------- | | id | string | Unique ID of selected statement | | check\_number | string | External ID of pay stub from payroll provider | | pay\_date | date | Pay date | | net\_pay | string | Net pay | | net\_pay\_ytd | string | Net pay year to date | | gross\_pay | string | Gross pay | | gross\_pay\_ytd | string | Gross pay year to date | | bonus | string | Bonus amount | | commission | string | Commission amount | | hours | string | Total work hours during a pay period | | basis\_of\_pay | string | Basis of pay: `S` - Salary, `H` - Hourly, `D` - Daily, `W` - Weekly, `M` - Monthly | | period\_start | date | Pay period start | | period\_end | date | Pay period end | | regular | string | Regular salary | | regular\_ytd | string | Regular salary year to date | | other\_pay\_ytd | string | All other pay forms year to date | | bonus\_ytd | string | Bonus year to date | | commission\_ytd | string | Commission year to date | | overtime | string | Overtime pay | | overtime\_ytd | string | Overtime pay year to date | | other\_pay | string | Other pay | | earnings | array of objects | Earnings for pay cycle by type | | earnings\_ytd | array of objects | Earnings year to date | | deductions | array of objects | Deductions for the pay cycle by type | | deductions\_ytd | array of objects | Deductions by type year to date | | md5sum | string | MD5 hash value computed based on file content | | file | url | Link to pay stub file (up to 2048 characters long) | | derived\_fields | array of strings | Array of derived fields | | missing\_data\_fields | array of strings | List of missing data fields from payroll response | ### Earnings object Each item in `earnings` and `earnings_ytd` has this shape. | Attribute | Type | Description | | :-------- | :----- | :---------------------------------------------------------------- | | name | string | Name of the earning | | amount | string | Amount of the earning | | category | string | One of: `regular`, `overtime`, `bonus`, `commission`, `other_pay` | | rate | string | Rate of the earning (nullable) | | units | string | Units for the earning (nullable) | ### Deductions object Each item in `deductions` and `deductions_ytd` has this shape. | Attribute | Type | Description | | :-------- | :----- | :-------------------------------------------------------------------------------------------------------------------- | | name | string | Name of the deduction | | amount | string | Amount of the deduction | | category | string | One of: `memo`, `medicare`, `retirement`, `socialsec`, `federal`, `state`, `benefit`, `garnishment`, `local`, `other` | *** ## Endpoints View the available endpoints for pay statements below. * [List all statements](/api-reference/statements/link-statements) * [Retrieve a statement](/api-reference/statements/retrieve-statement) *** ## Example response The JSON below is a sample response from the endpoint. ```json theme={null} { "id": "970c13c479b14f41b0b6a991ee8819f6", "pay_date": "2021-10-22", "net_pay": "1515.61", "net_pay_ytd": "35398.31", "gross_pay": "2153.85", "gross_pay_ytd": "45500.00", "bonus": null, "commission": null, "hours": "80.00", "basis_of_pay": "S", "period_start": "2021-10-03", "period_end": "2021-10-16", "regular": "2153.85", "regular_ytd": "42000.00", "bonus_ytd": "500.00", "commission_ytd": null, "overtime": null, "overtime_ytd": null, "other_pay": null, "other_pay_ytd": "3000.00", "earnings": [ { "name": "Regular", "category": "regular", "amount": "2153.85", "rate": "2153.85", "units": "72.00" } ], "earnings_ytd": [ { "name": "Regular", "category": "regular", "amount": "42000.00", "rate": null, "units": null }, { "name": "Spot Award", "category": "other_pay", "amount": "3000.00", "rate": null, "units": null }, { "name": "Bonus", "category": "bonus", "amount": "500.00", "rate": null, "units": null } ], "deductions": [ { "name": "Blue Ash Income Tax", "amount": "-26.94", "category": "local" }, { "name": "Medicare Tax", "amount": "-31.25", "category": "medicare" }, { "name": "CA State Income Tax", "amount": "-54.68", "category": "state" }, { "name": "Social Security Tax", "amount": "-133.63", "category": "socialsec" }, { "name": "Federal Income Tax", "amount": "-154.37", "category": "federal" }, { "name": "401K Dollars", "amount": "-237.37", "category": "retirement" } ], "deductions_ytd": [ { "name": "Federal Income Tax", "amount": "3639.64", "category": "federal" }, { "name": "Social Security Tax", "amount": "3090.03", "category": "socialsec" }, { "name": "401K Dollars", "amount": "2148.46", "category": "retirement" }, { "name": "CA State Income Tax", "amount": "1275.75", "category": "state" }, { "name": "Medicare Tax", "amount": "722.67", "category": "medicare" }, { "name": "Blue Ash Income Tax", "amount": "623.01", "category": "local" }, { "name": "Exp Repay", "amount": "-1397.87", "category": "benefit" } ], "md5sum": null, "file": null, "derived_fields": [], "missing_data_fields": [], "check_number": null } ```