v1

latestOpenAPI 3.1.02026-07-241642423.7 KB

Get company paydays

Returns a list of paydays and their corresponding approval_deadline specific to the processing period of the specified company. Results span one year of dates. If the approval_deadline was impacted by a bank holiday, then impacted_by_holiday will be true, otherwise false.

get/companies/{company}/paydays

Path parameters

companystring required

Return paydays for this company ID

Query parameters

startstring date

Return paydays on or after this date. If not a valid payday, the first date in the returned range will be the first valid payday after this date. If omitted, this endpoint will return items starting from today.

processing_period'three_day' | 'two_day' | 'one_day'

Return paydays for payrolls with the given processing period.

Response

200

nextstring
previousstring

Example response

{
  "next": "https://sandbox.checkhq.com/companies/com_H4eYDq9imaA5Ur3qwKA0/paydays?start=2026-10-26",
  "previous": "https://sandbox.checkhq.com/companies/com_H4eYDq9imaA5Ur3qwKA0/paydays?start=2024-10-24",
  "results": [
    {
      "payday": "2025-10-27",
      "approval_deadline": "2025-10-22",
      "approval_deadline_datetime": "2025-10-22T19:00:00Z"
    }
  ]
}