List EOR Payroll Calendar

Overview

The List EOR Payroll Calendar endpoint provides Remote parters access to the payroll schedule information for all active Employer of Record (EOR) entities supported by Remote. Unlike company-specific List Company Payroll Calendar, this endpoint returns generic, country-level payroll calendar data regardless of whether the employer has employees in those regions.

This endpoint is designed to help partners offer visibility into payroll frequencies, cut-off dates, pay days, etc. across EOR countries — making it ideal for use in early stages of the employee lifecycle.

Use case: This endpoint is for you if you want to inform employers about payroll schedules about a region before they start onboarding employees there, enabling partners to offer proactive guidance and planning support to their users.

ℹ️ This endpoint does not support the refresh token authorization flow.

To get the list of all active EOR payroll calendars, you need to request for an access token through client credentials authorization flow. Once you have a token, call the List EOR Payroll Calendar endpoint to get a similar response:

{
  "current_page": 1,
  "payroll_calendars": [
    {
      "country": {
        "alpha_2_code": "PT",
        "code": "PRT",
        "country_subdivisions": [
          {
            "code": "PT-06",
            "name": "Coimbra",
            "subdivision_type": "District"
          },
          {
            "code": "PT-11",
            "name": "Lisboa",
            "subdivision_type": "District"
          }
        ],
        "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"
        }
      ],
      "id": "8f7d9b2e-3a1c-4f5d-9e8b-7c6d5a4b3f2e"
    }
  ],
  "total_count": 1,
  "total_pages": 1
}

In this response, you have country information, region information, payroll cycle frequency, and the payroll cycle schedule in detail.