The payroll object

Represents a company's pay obligations for a payroll period.

Contains the total amount of money to withdraw from the company's account as part of paying employees and each employee’s compensation components.

Use the payroll object to tell Check about wages earned by employees in a given pay period for a specific payday. Preview the payroll to see employee net pay, after taxes, benefit deductions, and post tax deductions. Approve the payroll to confirm the calculations, and transition the payroll into the pending status. For more details, check out the Life of a Payroll guide.

{
  "id": "pay_Z26PNMC7Ky1wfFQzVqfF",
  "company": "com_sx3svU6K8c5ZkSFlOh5p",
  "period_start": "2019-06-16",
  "period_end": "2019-06-29",
  "approval_deadline": "2019-07-02T00:00:00.000000Z",
  "approved_at": "2019-06-29T18:26:56.848920Z",
  "payday": "2019-07-05",
  "status": "paid",
  "type": "regular",
  "pay_frequency": "biweekly",
  "funding_payment_method": "ach",
  "processing_period": "four_day",  
  "off_cycle_options": null,
  "managed": true,
  "totals": {
    "employee_gross": "961.54",
    "employee_reimbursements": "0.00",
    "employee_taxes": "249.23",
    "employee_benefits": "0.00",
    "post_tax_deductions": "0.00",
    "employee_net": "712.31",
    "contractor_gross": "100.00",
    "contractor_reimbursements": "15.00",
    "contractor_net": "115.00",
    "company_taxes": "73.56",
    "company_benefits": "0.00",
    "liability": "1150.10",
    "cash_requirement": "1150.10"
  },
  "items": [
    {
      "id": "itm_yvmmsVGFxLoBaMIkqzea",
      "payroll": "pay_Z26PNMC7Ky1wfFQzVqfF",
      "employee": "emp_zGGp6wYcxAeu1Ng8IA7v",
      "status": "draft",
      "payment_method": "direct_deposit",
      "net_pay": "712.31",
      "earnings": [
        {
          "amount": "961.54",
          "hours": 40.0,
          "type": "hourly",
          "workplace": "wrk_cxcG4vjGKcSXZk1fgKai",
          "code": null,
          "description": null
        }
      ],
      "reimbursements": [],
      "taxes": [
        {
          "tax": "tax_I1Z9zqbBGWIbvlZpN2Vq",
          "description": "New York SDI",
          "amount": "0.60",
          "payer": "employee"
        },
        {
          "tax": "tax_ImvSF9CTuMdokf0uwx5x",
          "description": "Employer FICA Tax",
          "amount": "59.62",
          "payer": "company"
        },
        {
          "tax": "tax_yjNkKk061BTipYv7G4Ti",
          "description": "New York City Tax",
          "amount": "31.04",
          "payer": "employee"
        },
        {
          "tax": "tax_S1krAkh75RzdWu5J53HA",
          "description": "New York State Tax",
          "amount": "44.20",
          "payer": "employee"
        },
        {
          "tax": "tax_UJrIQbtVErbdez0bYTVN",
          "description": "New York Family Leave Benefits",
          "amount": "1.47",
          "payer": "employee"
        },
        {
          "tax": "tax_1XHqR9Qf5t18SD2sfYEe",
          "description": "Medicare",
          "amount": "13.94",
          "payer": "employee"
        },
        {
          "tax": "tax_8L3JLfsH4X6dp0maBWfW",
          "description": "Federal Income Tax",
          "amount": "98.36",
          "payer": "employee"
        },
        {
          "tax": "tax_ibU8cGhC5OlpOjoQFIXV",
          "description": "FICA",
          "amount": "59.62",
          "payer": "employee"
        },
        {
          "tax": "tax_O3f21hkS1cvHBZTa61BO",
          "description": "Employer Medicare Tax",
          "amount": "13.94",
          "payer": "company"
        }
      ],
      "benefits": [],
      "benefit_overrides": [],
      "post_tax_deductions": [],
      "post_tax_deduction_overrides": [],
      "warnings": []
    }
  ],
  "contractor_payments": [
    {
      "contractor": "ctr_90QzaH9xPRI7JRLXnRoU",
      "payment_method": "manual",
      "amount": "100.00",
      "reimbursement_amount": "15.00",
      "net_pay": "115.00"
    }
  ],
  "is_void": false,
  "metadata": {}
}

Attribute	Description
id string	Unique identifier for the payroll.
company string	ID of the company that the payroll relates to.
period_start YYYY-MM-DD	Start of the date range that the payroll covers.
period_end YYYY-MM-DD	End of the date range that the payroll covers.
approval_deadline datetime	Datetime by which the payroll must be approved.
approved_at datetime	Datetime at which the payroll was approved. `null` for payrolls with a status of `draft`.
payday YYYY-MM-DD	Date on which employees will be paid for the payroll. A list of valid paydays for payrolls paid via direct deposit is available in the `/paydays` endpoint.
status string	Status of the payroll in its lifecycle. One of `draft`, `pending`, `processing`, `failed`, `partially_paid`, or `paid`.
type string	Indicates whether the payroll is a regular, off-cycle, or amendment payroll. One of `regular`,`off_cycle`, `amendment`, or `third_party_sick_pay`.
pay_frequency string	Frequency by which employees get paid. One of `weekly`, `biweekly`, `semimonthly`, `monthly`, `quarterly`, or `annually`.
funding_payment_method string	Payment method for funding the payroll. One of `ach` or `wire`.
pay_schedule string	ID of the pay schedule that the payroll relates to.
processing_period string	The processing period for this payroll. If not explicitly set, this value is set to the company's processing period at the time when the payroll is created.
off_cycle_options off-cycle options object	Additional configuration options controlling off-cycle payroll behavior. `null` for payrolls of type `regular`.
managed boolean	Indicates whether the payroll's lifecycle is being managed by Check.
totals totals object	Calculated totals for various payroll categories. `null` for payrolls with a status of `draft` outside of the preview endpoint.
items array of payroll item objects	The set of payroll items associated with the payroll.
contractor_payments array of contractor payment objects	The set of contractor payments associated with the payroll.
is_void boolean	Indicates whether a payroll is a void.
metadata object	Additional loosely structured information to associate with the payroll.