v1

latestOpenAPI 3.1.02026-07-242735131.1 MB
Payroll Calendars

List Company Payroll Calendar

List all payroll calendars for the company within the requested cycle.

Scopes

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage payroll runs (payroll)View payroll calendars (payroll_calendar:read)-
get/v1/payroll-calendars/{cycle}

Path parameters

cyclestring required

The cycle for which to list the payroll calendars. Format: YYYY-MM

Query parameters

pageinteger

Starts fetching records after the given page

page_sizeinteger

Number of items per page

Response

Success

Example response

{
  "current_page": 1,
  "payroll_calendars": [
    {
      "country": {
        "alpha_2_code": "PT",
        "code": "PRT",
        "contractor_products_available": [
          "standard",
          "plus",
          "cor"
        ],
        "country_subdivisions": [
          {
            "code": "PT-06",
            "name": "Coimbra",
            "subdivision_type": "District"
          },
          {
            "code": "PT-11",
            "name": "Lisboa",
            "subdivision_type": "District"
          }
        ],
        "employment_agreement_preview_available": true,
        "eor_onboarding": true,
        "locked_benefits": "after_first_hire",
        "name": "Portugal",
        "region": "Europe",
        "subregion": "Southern Europe",
        "supported_json_schemas": [
          "additional_documents",
          "address_details",
          "administrative_details",
          "employment-basic-information",
          "bank_account_details",
          "contract_details",
          "emergency_contact"
        ]
      },
      "cycle_frequency": "monthly",
      "cycles": [
        {
          "employee_inclusion_cutoff_date": "2021-01-20",
          "end_date": "2021-01-31",
          "input_cutoff_date": "2021-01-15",
          "payment_date": "2021-01-25",
          "start_date": "2021-01-01"
        }
      ],
      "owned_by_remote": true
    }
  ],
  "total_count": 1,
  "total_pages": 1
}