For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeel Home
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
  • Resources
    • Blog
    • Community
    • API spec
  • Endpoints
      • POSTCancel EOR Contract
      • PATCHDelay EOR employee onboarding
      • GETFetch EOR Contract form
      • GETFetch Start Date for EOR Contracts
      • GETGet EOR Additional Costs
      • GETRetrieve Benefits by Country
      • GETRetrieve detailed hiring guide for a country
      • POSTSign EOR contract document
      • PATCHUpdate Employee Information for EOR Contract
    • PATCHProfiles
LogoLogo
SupportDeel Home
EndpointsEor Hiring

Fetch Start Date for EOR Contracts

GET
/eor/start-date
GET
/rest/v2/eor/start-date
$curl -G https://api.letsdeel.com/rest/v2/eor/start-date \
>     -H "Authorization: Bearer <token>" \
>     -d employment_country=US \
>     -d employee_nationality=BR \
>     -d work_visa=true \
>     -d team_id=123e4567-e89b-12d3-a456-426614174001 \
>     -d legal_entity_id=123e4567-e89b-12d3-a456-426614174001 \
>     -d employment_state=CA \
>     -d special_job_id=123e4567-e89b-12d3-a456-426614174001
1{
2  "data": {
3    "min_start_date": "2025-05-19T21:09:54.630Z",
4    "start_date_buffer": 1,
5    "first_payroll_lock": 20,
6    "is_same_month_payment_country": false
7  }
8}
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`
Was this page helpful?
Previous

Get EOR Additional Costs

Next
Built with

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 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/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

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.

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

Learn more about authentication

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