🚀 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
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
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.
Added new optional field in requestBody: status - Status for the time off request. When set to REQUESTED the time off should be reviewed later through the Approve/Reject time off api.
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:
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
We are introducing a set of new API endpoints to enhance support for Employer of Record (EOR) worker operations, including compliance document management and bank account handling.
📌 New Endpoints
🗂️ Compliance Documents
GET/v2/eor/workers/compliance-documents
Returns a list of required and optional compliance documents associated with an EOR employee.
Scopes: worker:read
Allowed tokens: OAUTH2:PERSONAL
GET/v2/eor/workers/compliance-documents/:document_id/templates/download
Retrieves a downloadable template for a specific compliance document, if available.
Scopes: worker:read
Allowed tokens: OAUTH2:PERSONAL
GET/v2/eor/workers/banks/guide
Provides a structured guide (form schema) for submitting bank account details.
Scopes: worker:read
Allowed tokens: OAUTH2:PERSONAL
POST/v2/eor/workers/banks
Allows submission of bank account details for an EOR employee.
Scopes: worker:write
Allowed tokens: OAUTH2:PERSONAL
✍️ Contract Agreement Operations
POST/v2/eor/workers/contracts/:contract_id/signatures
Enables workers to sign a contract by submitting a typed signature.
Scopes: worker:write
Allowed tokens: OAUTH2:PERSONAL
GET/v2/eor/workers/contracts/:contract_id/offer-letter
Returns a rendered HTML preview of the job offer letter for a specific EOR contract.
Scopes: worker:read
Allowed tokens: OAUTH2:PERSONAL
GET/v2/eor/workers/contracts/:contract_id/employee-agreement/download
Provides a downloadable PDF link to the employee agreement associated with the given EOR contract.
Scopes: worker:read
Allowed tokens: OAUTH2:PERSONAL
📋 Key Highlights
🔍 Dynamic Field Support
Bank account forms are now dynamically defined via the guide endpoint, enabling country-specific validations and input schemas.
📎 Template-Driven Document Submission
Workers can now download blank templates for required compliance documents directly via the API.
🖊️ Contract Signing
Sign employment contracts digitally with a simple string-based signature submission.
📄 Offer Letter Rendering
Allows workers to preview the HTML-formatted job offer letter for EOR contracts.
📃 Employee Agreement Download
Enables clients to preview or download the finalized employee agreement, giving full transparency and access to finalized contractual documentation.
