GuidesAPI ReferenceChangelog
Changelog

Updated: POST Create Hourly Report Preset

Added a new required property worker_statement_id to the hourly report preset creation endpoint.

Endpoint: POST /rest/v2/timesheets/presets

API Reference: Create Hourly Report Preset


Updated: GET Retrieve a single contract

Added worker_statement_id property to the Get Contract by ID endpoint for use in hourly report preset creation.

Endpoint:GET /rest/v2/contracts/{contract_id}

API Reference: Retrieve a single contract

πŸš€ Enhancements for retrieve Benefits by Country EOR API

Updated: Retrieve Benefits by Country API

Added new response field: providers[].is_unisure

Endpoint: GET /v2/eor/benefits

API Reference: Retrieve Benefits by Country

πŸš€ Enhancements for retrieve EOR contract creation and Contract details

Added new response field: Adapted breakdown_costs response field content to better structure the employment costs as they are expected to be presented to the user.

Endpoint: GET /v2/eor/contracts/{contract_id}/detailsand POST /v2/eor

API Reference: Retrieve EOR Contract Details and Create an EOR contract

πŸš€ Enhancements for time_offs endpoints

✨ What's New

  • POST /v2/time_offs/validate
    Changed requestBody is_paid property to don't have a default value, instead it will use the default resolution logic on time-off service
  • PATCH /v2/time_offs/:time_off_id
    Added attachments to the response
  • POST /v2/time_offs
    Added attachments to the response
    Improved the description for is_paid in the request body

πŸš€ Enhancements for POST /rest/v2/immigration/client/cases

✨ What's New

  • Updated Immigration API specification to enforce stricter validation rules based on case_type.
  • Refined request and response schemas to align with the latest OpenAPI specifications.
  • No changes to actual request or response parameters β€” only added stricter validation (e.g., optional fields, enum constraints, length limits).

πŸš€ Enhancements for POST /rest/v2/eor

✨ What's New

We've introduced two new optional fields to the request payload of the POST /rest/v2/eor endpoint to provide greater flexibility and compliance with local labor regulations:
API reference

πŸ”Ή employment.sick_leave_days (optional)

  • Description: Specifies the number of sick leave days for the employee.
  • Validation: Must comply with the legal limits and regulations of the employee's country.
  • Use Case: Helps you manage employee benefits in line with regional policies.

πŸ”Ή employment.seniority_date (optional)

  • Description: Represents the original employment start date for employees who are already working with your organization (directly or via third parties).
  • Availability: Supported in select countries only.
  • Use Case: Ensures accurate tracking of employee tenure and benefits eligibility.

πŸš€ New Endpoints & Enhancements

We’re excited to announce several new updates and improvements across our Time Off and Timesheets APIs to make your integrations more powerful and flexible. Below is a detailed breakdown of the latest changes:


✨ Time Off API Enhancements

πŸ”Ή Create Time Off

Endpoint: POST /rest/v2/time-offs
Scopes: time-off:write
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

What’s new:

  • βœ… You can now request time-offs using only the policy_id, removing the need to specify a time_off_type_id.
  • πŸ•’ Support added for requesting time-offs with a PENDING status.
  • πŸ“… The start_date and end_date fields now accept both YYYY-MM-DD and ISO 8601 date formats. We recommend using YYYY-MM-DD for consistency.
  • πŸ“Ž File attachments are now supported when submitting requests via multipart/form-data.

πŸ”Ή Update Time Off

Endpoint: PATCH /rest/v2/time-offs/:id
Scopes: time-off:write
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

What’s new:

  • βœ… Time-off updates now support using only the policy_id, removing the requirement for time_off_type_id.
  • πŸ“… Updated support for start_date and end_date parameters in both YYYY-MM-DD and ISO string formats (we recommend YYYY-MM-DD).
  • πŸ“Ž Edit time-offs with file attachments using multipart/form-data.

πŸ†• New Endpoint: Daily Time Off Configurations

Endpoint: GET /rest/v2/time-offs/dailies
Scopes: time-off:read
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

What it does:
Fetch comprehensive daily information for a given date range tied to an hrisProfile:

  • πŸ—“ Work Schedule: Breakdown of working hours by weekday.
  • πŸŽ‰ Holidays: Holidays occurring within the specified date range.
  • πŸ“˜ Time Off Dailies: Daily records including holiday or work status.

⏱ Timesheets API – New Endpoints for Hourly Report Root Presets

πŸ†• Create Hourly Report Root Preset

Endpoint: POST /rest/v2/timesheets/root-presets
Scopes: timesheets:write
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

Create a new root preset for hourly reports to streamline your reporting setup.


πŸ†• Get All Hourly Report Root Presets

Endpoint: GET /rest/v2/timesheets/root-presets
Scopes: timesheets:read
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

Retrieve a list of all existing hourly report root presets.


πŸ†• Get a Specific Hourly Report Root Preset

Endpoint: GET /rest/v2/timesheets/root-presets/:id
Scopes: timesheets:read
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

Fetch detailed information about a specific preset by ID.

✨ New Time-Off Endpoints

πŸ†• POST /rest/v2/time-offs/validate

Validate a time-off request before submission.

  • Enables pre-validation of new or updated time-off requests for given dates.
  • Returns:
    • Validation errors, if the request cannot be processed.
    • Pre-calculation of time-off usage.
    • Daily breakdown of available time-off for easier user selection.
  • ⚑ It is required to call this endpoint before submitting or updating a time-off request.

πŸ”— API Reference: Validate Time-Off
πŸ”’ Scopes Required: time-off:read
πŸ”‘ Supported Token Types: OAUTH2:PERSONAL, OAUTH2:ORGANIZATIONAL, PAT:PERSONAL, PAT:ORGANIZATIONAL


πŸ†• POST /rest/v2/time-offs/review

Batch approve or reject multiple time-off requests.

  • Allows reviewing (approving/rejecting) multiple pending time-off requests in a single API call.
  • Designed to integrate with workflows where time-off requests are initially submitted with a pending approval status.
  • Great for automating bulk approval/review processes via API.

πŸ”— API Reference: Approve/Reject Time-Off Requests
πŸ”’ Scopes Required: time-off:write
πŸ”‘ Supported Token Types: OAUTH2:PERSONAL, OAUTH2:ORGANIZATIONAL, PAT:PERSONAL, PAT:ORGANIZATIONAL

New Visa Requirement Endpoint + EOR & People API Enhancements

✨ New Feature

βž• Added Check Visa Requirement Endpoint

  • Endpoint: GET /v2/immigration/visa-requirement/:country_code
  • Description:
    Use this endpoint to determine if a work visa is required for a specific employment country, given the employee’s nationality or multiple nationalities.
    Ideal for ensuring early-stage compliance during employee onboarding.

πŸ”§ Update

πŸ”„ Updated POST /v2/eor Response Schema

  • Added the following missing fields under benefits:
    • cover_all – Indicates whether the benefit applies to all employees.
    • cover_dependents – Indicates whether dependents are also covered under the benefit.

These updates enhance the completeness and accuracy of the benefits object in the EOR payload.



πŸ”§ Update

πŸ”„ Updated PUT /v2/people/{id}/department

  • Added optional query param: replace_other_positions: Indicates if this department position should replace all other positions or only append to the existing ones.

πŸ”„ Updated GET /v2/people/{hrisProfileOid} Response Schema

  • Added new response field: profile_organizational_structures

EOR retrieve Benefits by Country API

Updated: Retrieve Benefits by Country API

Added new response fields: providers[].contribution_options, providers[].min_contribution, providers[].max_contribution.

Endpoint: GET /v2/eor/benefits

API Reference: Retrieve Benefits by Country