GuidesAPI ReferenceChangelog
Changelog
added

v2.1.61

Forms: EOR Additional Fields & Benefits List

GET Worker Additional Fields for EOR by Country

A new endpoint has been implemented to retrieve the list of additional fields required when onboarding an Employee of Record (EOR) worker. This endpoint returns country-specific fields that must be completed during the worker profile creation process.

Use Case: Implement this endpoint to dynamically generate forms for collecting required worker information during the EOR onboarding process.

Note: The previously used endpoint /forms/eor/worker-sign-fields/ has been deprecated and should no longer be used in the creation flow.

Endpoint: GET /rest/v2/forms/eor/worker-additional-fields/{country_code}

API Reference: Get worker additional fields for EOR

curl --request GET \
     --url https://api.letsdeel.com/rest/v2/forms/eor/worker-additional-fields/GB \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {YOUR_TOKEN}'

GET List of Benefits by Country

A new endpoint has been implemented to retrieve available benefits for Employee of Record contracts. This endpoint returns both mandatory and optional benefits with their associated plans and providers, filtered by several parameters including country code, work visa status, working hours, employment type, team, and entity identification.

Use Case: Implement this endpoint to display appropriate benefit options during EOR contract creation.

Endpoint: GET /v2/eor/benefits

Query Parameters:

  • country_code - ISO country code
  • work_visa - Boolean indicating visa status
  • work_hours_per_week - Numeric value of weekly work hours
  • employment_type - Type of employment (e.g., "Full-time")
  • team_id - UUID of the team
  • legal_entity_id - UUID of the legal entity

API Reference: Get list of benefits per country

curl --request GET \
     --url 'https://api.letsdeel.com/rest/v2/eor/benefits?country_code=US&work_visa=true&work_hours_per_week=40&employment_type=Full-time&team_id=123e4567-e89b-12d3-a456-426614174000&legal_entity_id=123e4567-e89b-12d3-a456-426614174000' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {YOUR_TOKEN}'