Retrieve EOR Contract Details

GET

/eor/contracts/:contract_id/details

GET

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

1 import requests
2 
3 url = "https://api.letsdeel.com/rest/v2/eor/contracts/38j84xg/details"
4 
5 headers = {"Authorization": "Bearer <token>"}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

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 or null

The unique identifier for the Deel contract.

namestring or null

Contract name

teamobject or null

salarystring or null

Annual salary as a string to preserve decimal precision.

statusenum or null

The current status of the contract.

creatorobject or null

currencystring or null

The currency used in the contract.

employeeobject or null

Employee details

end_datestring or nullformat: "date-time"

The end date of the contract, if applicable.

timezonestring or null

The timezone of the contract.

seniorityobject or null

sick_daysobject or null

Allowed sick days range.

work_visaboolean or null

Indicates if a work visa is required.

created_atstring or nullformat: "date-time"

The date and time when the contract was created.

start_datestring or nullformat: "date-time"

The start date of the contract.

updated_atstring or nullformat: "date-time"

The date and time when the contract was last updated.

descriptionstring or null

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 or null

Payroll frequency for the contract

Allowed values:

can_adjust_onobject or null

Time frame when adjustments can be made.

contract_typeenum or null

The type of contract.

Allowed values:

scope_of_workstring or null

Description of job scope and responsibilities.

signing_bonusstring or null

One-time bonus paid at contract sign.

time_off_typeenum or null

Type of time off policy.

Allowed values:

deposit_monthsstring or null

Number of deposit months required.

effective_datestring or nullformat: "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 or null

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 or null

Number of days in the probation period.

employee_signed_atstring or nullformat: "date-time"

Date and time when the employee signed.

employment_countrystring or null

Two letter country code of the employment country.

notice_period_typeenum or null

Type of notice period if applicable.

Allowed values:

original_start_datestring or nullformat: "date-time"

The originally planned start date.

work_hours_per_weekstring or null

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_datestring or nullformat: "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 or null

Whether onboarding is currently on hold or not.

monthly_employer_coststring or null

Monthly cost to the employer.

employee_late_sign_startstring or nullformat: "date-time"

Date when employee signed late, if applicable.

is_early_invoice_enabledboolean or null

Whether early invoicing is enabled or not.

onboarding_step_durationinteger or null

Duration of onboarding steps in days.

variable_compensation_idslist of strings or null

List of variable compensation IDs.

can_remind_employee_to_signboolean or null

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

initial_effective_plain_datestring or nullformat: "date"

The initial effective date in plain format.

is_foreign_currency_contractboolean or null

Whether the contract uses foreign currency or not.

is_employee_onboarding_delayedboolean or null

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

monthly_eor_management_fee_usdstring or null

Monthly EOR management fee in USD.

work_schedule_assignment_settingsenum or null

Work schedule assignment setting.

Allowed values:

probation_period_type_for_definiteenum or null

Probation period type for definite contracts.

Allowed values:

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

Authentication

Authentication

Path parameters

Response

Errors

Authentication