Retrieve EOR Contract Details

GET

/eor/contracts/:contract_id/details

GET

/rest/v2/eor/contracts/:contract_id/details

1 curl https://api.letsdeel.com/rest/v2/eor/contracts/38j84xg/details \
2      -H "Authorization: Bearer <token>"

1 {
2   "id": "38j84xg",
3   "name": "John Doe - 3D Artist",
4   "team": {
5     "id": "c4d1b604-54ef-4856-b561-d7cd90e2e306",
6     "name": "Cool team"
7   },
8   "salary": "150000.0000",
9   "status": "under_review",
10   "creator": {
11     "name": "John Doe",
12     "email": "510cd749d273e83a197ebd9e4342336f@test.com",
13     "firstname": "John"
14   },
15   "currency": "MXN",
16   "employee": {
17     "email": "albert.einstein@test.com",
18     "pic_url": "https://media.letsdeel.com/avatar/XXXXXXXX?q=0000000000000",
19     "last_name": "Einstein",
20     "first_name": "Albert",
21     "legal_name": "Albert Einstein",
22     "nationality": "MX"
23   },
24   "end_date": "2026-08-10T23:59:59.999Z",
25   "timezone": "UTC",
26   "seniority": {
27     "id": 185,
28     "name": "Junior (Individual Contributor Level 1)"
29   },
30   "sick_days": {
31     "max": "364.0000",
32     "min": "0.0000"
33   },
34   "work_visa": false,
35   "created_at": "2025-04-02T20:31:01.645Z",
36   "start_date": "2025-04-04T00:00:00.000Z",
37   "updated_at": "2025-04-02T20:31:02.993Z",
38   "description": "Duties and Responsibilities\n\n- Create detailed business plans designed to attain predetermined goals and quotas.",
39   "signed_date": "2025-04-04T03:09:15.378Z",
40   "cancelled_at": "2025-04-04T03:09:15.378Z",
41   "completed_at": "2025-04-04T03:09:15.378Z",
42   "payroll_type": "BIMONTHLY",
43   "can_adjust_on": {
44     "end": "2025-04-20T00:00:00.000Z",
45     "start": "2025-04-04T00:00:00.000Z"
46   },
47   "contract_type": "eor",
48   "scope_of_work": "Duties and Responsibilities\n\n- Create detailed business plans designed to attain predetermined goals and quotas.\n- Manage the entire sales cycle from finding a client to securing a deal.\n- Unearth new sales opportunities through networking and turn them into long-term partnerships.\n- Present products to prospective clients.\n- Provide professional after-sales support to maximize customer loyalty.\n- Remain in regular contact with your clients to understand and meet their needs.\n- Respond to complaints and resolve issues to the customer's satisfaction and to maintain the company's reputation.\n- Negotiate agreements.\n- Maintains all sales databases necessary to report sales activity and customer information.\n- Attends all sales meetings and training sessions as required by management.",
49   "signing_bonus": "18770.0000",
50   "time_off_type": "STANDARD",
51   "deposit_months": "1.50",
52   "effective_date": "2025-04-04T00:00:00.000Z",
53   "job_title_name": "3D Artist",
54   "completion_date": "2025-04-04T00:00:00.000Z",
55   "employment_type": "Full-time",
56   "client_signature": "Alice Banks",
57   "client_signed_at": "2025-04-04T00:00:00.000Z",
58   "employment_costs": {
59     "summary": {
60       "salary": "700,000.00",
61       "currency": "EUR",
62       "exchange_rate": "0.92",
63       "totals_formatted": [
64         {
65           "title": "Monthly total",
66           "total": "61,613.86",
67           "frequency": "monthly",
68           "total_supporting": "67,116.35"
69         }
70       ],
71       "supporting_currency": "USD"
72     },
73     "sections": [
74       {
75         "name": "MONTHLY_EMPLOYMENT_BREAKDOWN",
76         "label": "Monthly employment breakdown",
77         "groups": [
78           {
79             "name": "GROSS_MONTHLY_SALARY",
80             "costs": [
81               {
82                 "label": "Salary",
83                 "totals": [
84                   {
85                     "total": "58,333.33",
86                     "frequency": "monthly",
87                     "total_supporting": "63,542.84"
88                   }
89                 ]
90               }
91             ],
92             "label": "Gross salary",
93             "totals": [
94               {
95                 "total": "58,633.33",
96                 "frequency": "monthly",
97                 "total_supporting": "63,869.63"
98               }
99             ],
100             "has_breakdown": true
101           }
102         ],
103         "totals": [
104           {
105             "total": "61,613.86",
106             "frequency": "monthly",
107             "total_supporting": "67,116.35"
108           }
109         ],
110         "is_summarized": true,
111         "standalone_items": [
112           {
113             "name": "One off payment",
114             "label": "Printed Agreement handling fee",
115             "totals": [
116               {
117                 "total": "73.44",
118                 "frequency": "monthly",
119                 "total_supporting": "80.00"
120               }
121             ]
122           }
123         ]
124       }
125     ],
126     "additional_data": {
127       "annual_notes": [],
128       "monthly_notes": [],
129       "once_off_notes": [],
130       "additional_notes": [
131         "Kindly note that the onboarding process for employees in this country requires the completion of a QES (Qualified Electronic Signature) process, which carries a fee of $80 USD. This fee is designed to cover the additional administrative expenses associated with the QES process. In the event that the QES option is not available, an alternative would be to proceed with a printed agreement signature process, incurring costs of $80 USD. These costs include expenses for printing, shipping, and handling related to the signing of the printed agreement.",
132         "Deel can countersign the employment agreement once you provide a Qualifying Electronic Signature (QES). After the employee registers on the Deel platform, we will notify and invite you to sign the Scope of Work, through the QES process. Please note that we are unable to proceed with your employee full onboarding until you complete this QES signing step."
133       ]
134     }
135   },
136   "employment_state": "NJ",
137   "hiring_objective": {
138     "type": "ONE_OFF_HIRE",
139     "extra_info": "Planning to hire more soon"
140   },
141   "probation_period": 30,
142   "employee_signed_at": "2025-04-04T00:00:00.000Z",
143   "employment_country": "US",
144   "notice_period_type": "STANDARD",
145   "original_start_date": "2025-04-04T00:00:00.000Z",
146   "work_hours_per_week": "40.00",
147   "contractor_signature": "Charles Dickens",
148   "contractor_signed_at": "2025-04-04T00:00:00.000Z",
149   "effective_plain_date": "2025-04-04",
150   "fixed_adjustment_ids": [
151     "cm90dtiahuzmu5a0oyt3090b8"
152   ],
153   "invited_client_email": "employer@test.com",
154   "last_quote_rejection": {
155     "created_at": "2025-04-04T03:09:15.378Z",
156     "rejected_by": {
157       "name": "Stephen King",
158       "profile_public_id": "e2ad9db5-e245-4ffb-a13d-1c1c2f82c91b"
159     },
160     "rejection_type": "CLIENT",
161     "rejection_reason": "DECIDED_AGAINST_EMPLOYING_EOR",
162     "rejection_message": "Scope is too broad"
163   },
164   "completion_plain_date": "2024-12-31",
165   "is_onboarding_on_hold": false,
166   "monthly_employer_cost": "4709.9400",
167   "employee_late_sign_start": "2025-04-08T03:09:15.378Z",
168   "is_early_invoice_enabled": false,
169   "onboarding_step_duration": 3,
170   "variable_compensation_ids": [
171     "cm90dtiaivl0mbqmflsu5asek"
172   ],
173   "can_remind_employee_to_sign": false,
174   "initial_effective_plain_date": "2025-04-04",
175   "is_foreign_currency_contract": false,
176   "is_employee_onboarding_delayed": false,
177   "monthly_eor_management_fee_usd": "500.0000",
178   "work_schedule_assignment_settings": "NOT_AVAILABLE",
179   "probation_period_type_for_definite": "STANDARD"
180 }

Returns the basic information for an EOR contract, along with employment costs associated to it 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/

Path parameters

contract_idstringRequired

The unique identifier for the Deel contract

Response

Successful response

idstring

The unique identifier for the Deel contract.

namestring

Contract name

teamobject

salarystring

Annual salary as a string to preserve decimal precision.

statusenum

The current status of the contract.

creatorobject

currencystring

The currency used in the contract.

employeeobject

Employee details

end_datestring or nullformat: "date-time"

The end date of the contract, if applicable.

timezonestring

The timezone of the contract.

seniorityobject

sick_daysobject

Allowed sick days range.

work_visaboolean

Indicates if a work visa is required.

created_atstringformat: "date-time"

The date and time when the contract was created.

start_datestringformat: "date-time"

The start date of the contract.

updated_atstringformat: "date-time"

The date and time when the contract was last updated.

descriptionstring

Contract description

signed_datestring or nullformat: "date-time"

The date and time when the contract was signed by both parties.

cancelled_atstring or nullformat: "date-time"

The date and time when the contract was cancelled.

completed_atstring or nullformat: "date-time"

The date and time when the contract was completed.

payroll_typeenum

Payroll frequency for the contract

Allowed values:

can_adjust_onobject or null

Time frame when adjustments can be made.

contract_typeenum

The type of contract.

Allowed values:

scope_of_workstring

Description of job scope and responsibilities.

signing_bonusstring or null

One-time bonus paid at contract sign.

time_off_typeenum

Type of time off policy.

Allowed values:

deposit_monthsstring or null

Number of deposit months required.

effective_datestringformat: "date-time"

The date and time when the contract is effective.

job_title_namestring or null

The contract's job title.

completion_datestring or nullformat: "date-time"

The completion date of the contract.

employment_typeenum

The type of employment.

Allowed values:

client_signaturestring or null

The signature of the client.

client_signed_atstring or nullformat: "date-time"

The date and time when the client signed the contract.

employment_costsobject or null

Detailed breakdown of employment costs including summary totals, sectioned cost groups, and additional context notes.

employment_statestring or null

The state of the employment.

hiring_objectiveobject or null

Information about the hiring objective.

probation_periodinteger

Number of days in the probation period.

employee_signed_atstring or nullformat: "date-time"

Date and time when the employee signed.

employment_countrystring

Two letter country code of the employment country.

notice_period_typeenum or null

Type of notice period if applicable.

Allowed values:

original_start_datestringformat: "date-time"

The originally planned start date.

work_hours_per_weekstring

Number of work hours per week.

contractor_signaturestring or null

The signature of the EOR entity representative.

contractor_signed_atstring or nullformat: "date-time"

The date and time when the contractor signed the contract.

effective_plain_datestringformat: "date"

The effective date in plain format.

fixed_adjustment_idslist of strings or null

List of fixed adjustment ids.

invited_client_emailstring or null

The email address of the invited client.

last_quote_rejectionobject or null

Timestamp of last quote rejection.

completion_plain_datestring or nullformat: "date"

The completion date of the contract in plain contract.

is_onboarding_on_holdboolean

Whether onboarding is currently on hold or not.

monthly_employer_coststring

Monthly cost to the employer.

employee_late_sign_startstring or nullformat: "date-time"

Date when employee signed late, if applicable.

is_early_invoice_enabledboolean

Whether early invoicing is enabled or not.

onboarding_step_durationinteger or null

Duration of onboarding steps in days.

variable_compensation_idslist of strings

List of variable compensation IDs.

can_remind_employee_to_signboolean

Whether reminders to sign the employee resignation can be sent to the employee or not.

initial_effective_plain_datestringformat: "date"

The initial effective date in plain format.

is_foreign_currency_contractboolean

Whether the contract uses foreign currency or not.

is_employee_onboarding_delayedboolean

Determines if the invite for employee onboarding should be dispatch manually.

monthly_eor_management_fee_usdstring

Monthly EOR management fee in USD.

work_schedule_assignment_settingsenum

Work schedule assignment setting.

Allowed values:

probation_period_type_for_definiteenum or null

Probation period type for definite contracts.

Allowed values:

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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