Fetch Start Date for EOR Contracts | Deel

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

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.

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

Learn more about authentication

## 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)

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

$	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	}

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