Skip to navigation
EOR EndpointsEOR hiring

Fetch Start Date for EOR Contracts

Returns the earliest allowed start date for a new EOR contract quote based on the specified employment country, nationality, and visa requirements. The response also includes payroll timing parameters — start_date_buffer, first_payroll_lock, and is_same_month_payment_country — that govern when the contract can take effect.

Token scopes: contracts:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

employment_countrystringRequiredformat: "^[A-Z]{2}$"

Employment country in ISO 3166-1 alpha-2 format

employee_nationalitystringOptionalformat: "^[A-Z]{2}$"

Employee nationality in ISO 3166-1 alpha-2 format

work_visabooleanOptional
Whether a work visa is required
team_idstringRequired
Team ID
legal_entity_idstringOptional
Legal entity ID
employment_statestringOptional
State or province of employment
special_job_idstringOptional

Special job ID (if applicable)

Response

Start date details
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error