List Payroll Calendar

Remote offers payroll calendar API to help employers retrieve details about the payroll schedule. There are two endpoints in this API:

  • List Company Payroll Calendar endpoint that returns all payroll calendars associated with a company for a specific payroll cycle. However, there is a need to support a broader use case allowing partners to retrieve generic payroll schedule information for all countries where Remote is the Employer of Record (EOR).
  • The List EOR Payroll Calendar endpoint enables partners to get a list of all payroll calendars in Remote's EOR regions regardless of whether the employer has employees onboarded in those regions.

The table below breaks down the difference between these two endpoints.

FeatureList Company Payroll CalendarList EOR Payroll Calendar
ScopeRetrieves payroll calendars specific to your organization and only where employees have been onboarded.Retrieves payroll calendars for all active EOR entities, regardless of whether the company has employees in those locations.
PurposeUsed by companies to manage and view payroll schedules tied to their existing employee base.Designed for Remote partners to display generic country-level payroll info before hiring.
AuthenticationRequires OAuth token with either employment.read or employment.manage scopes.Only works with client credentials.
OutputReturns data specific to the provided month/year cycle.Returns all active EOR calendars.