---
updatedAt: 2026-06-18T18:55:55.000Z
agentTools:
  projectIndex: https://docs.checkhq.com/llms.txt
---

# The pay schedule object

Represents a schedule on which a company pays its employees.

Use a pay schedule object to create a calendar of paydays specific to a company.

```json
{
    "id": "psc_KpOEeeH3kWMrxyzffjcn",
    "company": "com_FeToKDOuUyvQrQADcY2u",
    "name": "Test Schedule",
    "pay_frequency": "biweekly",
    "first_payday": "2021-04-16",
    "second_payday": null,
    "first_period_end": "2021-04-12",
    "metadata": {}
}
```

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `id`  
        _string_
      </td>

      <td>
        Unique identifier for the pay schedule.
      </td>
    </tr>

    <tr>
      <td>
        `company`  
        _string_
      </td>

      <td>
        ID of the company that this pay schedule relates to.
      </td>
    </tr>

    <tr>
      <td>
        `name`  
        _string_
      </td>

      <td>
        Human-readable name of the pay schedule.
      </td>
    </tr>

    <tr>
      <td>
        `pay_frequency`  
        _string_
      </td>

      <td>
        Frequency by which employees get paid.  

        One of `weekly`, `biweekly`, `semimonthly`, `monthly`, `quarterly`, or `annually`.
      </td>
    </tr>

    <tr>
      <td>
        `first_payday`  
        _YYYY-MM-DD_
      </td>

      <td>
        The payday date of the first payroll the company will run on Check on this pay schedule.
      </td>
    </tr>

    <tr>
      <td>
        `second_payday`  
        _YYYY-MM-DD_
      </td>

      <td>
        The payday date of the second payroll the company will run on Check on this pay schedule. This field should only be used with the `semimonthly` frequency to specify custom paydays besides the 15th and last day of the month. `second_payday` must be between one day and one month after `first_payday`.
      </td>
    </tr>

    <tr>
      <td>
        `first_period_end`  
        _YYYY-MM-DD_
      </td>

      <td>
        The period end date of the first payroll the company will run on Check on this pay schedule.
      </td>
    </tr>

    <tr>
      <td>
        `metadata`  
        _object_
      </td>

      <td>
        Additional loosely structured information to associate with the pay schedule.
      </td>
    </tr>
  </tbody>
</Table>