Retrieve EOR Contract Details

GET

/eor/contracts/:contract_id/details

GET

/rest/eor/contracts/:contract_id/details

$ curl https://api.letsdeel.com/rest/eor/contracts/38j84xg/details \
>      -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   "holidays": 25,
26   "timezone": "UTC",
27   "seniority": {
28     "id": 185,
29     "name": "Junior (Individual Contributor Level 1)"
30   },
31   "sick_days": {
32     "max": "364.0000",
33     "min": "0.0000"
34   },
35   "work_visa": false,
36   "created_at": "2025-04-02T20:31:01.645Z",
37   "start_date": "2025-04-04T00:00:00.000Z",
38   "updated_at": "2025-04-02T20:31:02.993Z",
39   "description": "Duties and Responsibilities\n\n- Create detailed business plans designed to attain predetermined goals and quotas.",
40   "hourly_rate": "50.00",
41   "signed_date": "2025-04-04T03:09:15.378Z",
42   "cancelled_at": "2025-04-04T03:09:15.378Z",
43   "completed_at": "2025-04-04T03:09:15.378Z",
44   "payroll_type": "BIMONTHLY",
45   "can_adjust_on": {
46     "end": "2025-04-20T00:00:00.000Z",
47     "start": "2025-04-04T00:00:00.000Z"
48   },
49   "contract_type": "eor",
50   "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.",
51   "signing_bonus": "18770.0000",
52   "time_off_type": "STANDARD",
53   "deposit_months": "1.50",
54   "effective_date": "2025-04-04T00:00:00.000Z",
55   "job_title_name": "3D Artist",
56   "completion_date": "2025-04-04T00:00:00.000Z",
57   "employment_type": "Full-time",
58   "hris_profile_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
59   "client_signature": "Alice Banks",
60   "client_signed_at": "2025-04-04T00:00:00.000Z",
61   "employment_costs": {
62     "summary": {
63       "salary": "700,000.00",
64       "currency": "EUR",
65       "exchange_rate": "0.92",
66       "totals_formatted": [
67         {
68           "title": "Monthly total",
69           "total": "61,613.86",
70           "frequency": "monthly",
71           "total_supporting": "67,116.35"
72         }
73       ],
74       "supporting_currency": "USD"
75     },
76     "sections": [
77       {
78         "name": "MONTHLY_EMPLOYMENT_BREAKDOWN",
79         "label": "Monthly employment breakdown",
80         "groups": [
81           {
82             "name": "GROSS_MONTHLY_SALARY",
83             "costs": [
84               {
85                 "label": "Salary",
86                 "totals": [
87                   {
88                     "total": "58,333.33",
89                     "frequency": "monthly",
90                     "total_supporting": "63,542.84"
91                   }
92                 ]
93               }
94             ],
95             "label": "Gross salary",
96             "totals": [
97               {
98                 "total": "58,633.33",
99                 "frequency": "monthly",
100                 "total_supporting": "63,869.63"
101               }
102             ],
103             "has_breakdown": true
104           }
105         ],
106         "totals": [
107           {
108             "total": "61,613.86",
109             "frequency": "monthly",
110             "total_supporting": "67,116.35"
111           }
112         ],
113         "is_summarized": true,
114         "standalone_items": [
115           {
116             "name": "One off payment",
117             "label": "Printed Agreement handling fee",
118             "totals": [
119               {
120                 "total": "73.44",
121                 "frequency": "monthly",
122                 "total_supporting": "80.00"
123               }
124             ]
125           }
126         ]
127       }
128     ],
129     "additional_data": {
130       "annual_notes": [],
131       "monthly_notes": [],
132       "once_off_notes": [],
133       "additional_notes": [
134         "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.",
135         "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."
136       ]
137     }
138   },
139   "employment_state": "NJ",
140   "hiring_objective": {
141     "type": "ONE_OFF_HIRE",
142     "extra_info": "Planning to hire more soon"
143   },
144   "probation_period": 30,
145   "compensation_type": "HOURLY",
146   "employee_signed_at": "2025-04-04T00:00:00.000Z",
147   "employment_country": "US",
148   "notice_period_type": "STANDARD",
149   "calculated_holidays": "20",
150   "original_start_date": "2025-04-04T00:00:00.000Z",
151   "work_hours_per_week": "40.00",
152   "contractor_signature": "Charles Dickens",
153   "contractor_signed_at": "2025-04-04T00:00:00.000Z",
154   "effective_plain_date": "2025-04-04",
155   "fixed_adjustment_ids": [
156     "cm90dtiahuzmu5a0oyt3090b8"
157   ],
158   "invited_client_email": "employer@test.com",
159   "last_quote_rejection": {
160     "created_at": "2025-04-04T03:09:15.378Z",
161     "rejected_by": {
162       "name": "Stephen King",
163       "profile_public_id": "e2ad9db5-e245-4ffb-a13d-1c1c2f82c91b"
164     },
165     "rejection_type": "CLIENT",
166     "rejection_reason": "DECIDED_AGAINST_EMPLOYING_EOR",
167     "rejection_message": "Scope is too broad"
168   },
169   "completion_plain_date": "2024-12-31",
170   "is_onboarding_on_hold": false,
171   "monthly_employer_cost": "4709.9400",
172   "employee_late_sign_start": "2025-04-08T03:09:15.378Z",
173   "is_early_invoice_enabled": false,
174   "onboarding_step_duration": 3,
175   "signing_bonus_payout_type": "FIRST_CYCLE",
176   "variable_compensation_ids": [
177     "cm90dtiaivl0mbqmflsu5asek"
178   ],
179   "can_remind_employee_to_sign": false,
180   "initial_effective_plain_date": "2025-04-04",
181   "is_foreign_currency_contract": false,
182   "is_employee_onboarding_delayed": false,
183   "monthly_eor_management_fee_usd": "500.0000",
184   "work_schedule_assignment_settings": "NOT_AVAILABLE",
185   "probation_period_type_for_definite": "STANDARD"
186 }

Returns basic contract information and associated employment costs for a specific EOR contract.

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

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

idstringOptional

The unique identifier for the Deel contract.

namestringOptional

Contract name

teamobjectOptional

salarystringOptional

Annual salary as a string to preserve decimal precision.

statusenumOptional

The current status of the contract.

creatorobjectOptional

currencystringOptional

The currency used in the contract.

employeeobjectOptional

Employee details

end_datestring or nullOptionalformat: "date-time"

The end date of the contract, if applicable.

holidaysinteger or nullOptional

Number of holidays for the contract.

timezonestringOptional

The timezone of the contract.

seniorityobjectOptional

sick_daysobjectOptional

Allowed sick days range.

work_visabooleanOptional

Indicates if a work visa is required.

created_atstringOptionalformat: "date-time"

The date and time when the contract was created.

start_datestringOptionalformat: "date-time"

The start date of the contract.

updated_atstringOptionalformat: "date-time"

The date and time when the contract was last updated.

descriptionstringOptional

Contract description

hourly_ratestring or nullOptional

Hourly rate as a string to preserve decimal precision.

signed_datestring or nullOptionalformat: "date-time"

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

cancelled_atstring or nullOptionalformat: "date-time"

The date and time when the contract was cancelled.

completed_atstring or nullOptionalformat: "date-time"

The date and time when the contract was completed.

payroll_typeenumOptional

Payroll frequency for the contract

can_adjust_onobject or nullOptional

Time frame when adjustments can be made.

contract_typeenumOptional

The type of contract.

scope_of_workstringOptional

Description of job scope and responsibilities.

signing_bonusstring or nullOptional

One-time bonus paid at contract sign.

time_off_typeenumOptional

Type of time off policy.

deposit_monthsstring or nullOptional

Number of deposit months required.

effective_datestringOptionalformat: "date-time"

The date and time when the contract is effective.

job_title_namestring or nullOptional

The contract's job title.

completion_datestring or nullOptionalformat: "date-time"

The completion date of the contract.

employment_typeenumOptional

The type of employment.

hris_profile_idstring or nullOptionalformat: "uuid"

The HRIS profile ID linked to this contract.

client_signaturestring or nullOptional

The signature of the client.

client_signed_atstring or nullOptionalformat: "date-time"

The date and time when the client signed the contract.

employment_costsobject or nullOptional

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

employment_statestring or nullOptional

The state of the employment.

hiring_objectiveobject or nullOptional

Information about the hiring objective.

probation_periodintegerOptional

Number of days in the probation period.

compensation_typeenum or nullOptional

Compensation type for the contract.

employee_signed_atstring or nullOptionalformat: "date-time"

Date and time when the employee signed.

employment_countrystringOptional

Two letter country code of the employment country.

notice_period_typeenum or nullOptional

Type of notice period if applicable.

calculated_holidaysstring or nullOptional

Calculated number of holidays as a string.

original_start_datestringOptionalformat: "date-time"

The originally planned start date.

work_hours_per_weekstringOptional

Number of work hours per week.

contractor_signaturestring or nullOptional

The signature of the EOR entity representative.

contractor_signed_atstring or nullOptionalformat: "date-time"

The date and time when the contractor signed the contract.

effective_plain_datestringOptionalformat: "date"

The effective date in plain format.

fixed_adjustment_idslist of strings or nullOptional

List of fixed adjustment ids.

invited_client_emailstring or nullOptional

The email address of the invited client.

last_quote_rejectionobject or nullOptional

Timestamp of last quote rejection.

completion_plain_datestring or nullOptionalformat: "date"

The completion date of the contract in plain contract.

is_onboarding_on_holdbooleanOptional

Whether onboarding is currently on hold or not.

monthly_employer_coststringOptional

Monthly cost to the employer.

employee_late_sign_startstring or nullOptionalformat: "date-time"

Date when employee signed late, if applicable.

is_early_invoice_enabledbooleanOptional

Whether early invoicing is enabled or not.

onboarding_step_durationinteger or nullOptional

Duration of onboarding steps in days.

signing_bonus_payout_typeenum or nullOptional

Defines when the signing bonus is paid. Set only when signing_bonus is present.

variable_compensation_idslist of stringsOptional

List of variable compensation IDs.

can_remind_employee_to_signbooleanOptional

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

initial_effective_plain_datestringOptionalformat: "date"

The initial effective date in plain format.

is_foreign_currency_contractbooleanOptional

Whether the contract uses foreign currency or not.

is_employee_onboarding_delayedbooleanOptional

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

monthly_eor_management_fee_usdstringOptional

Monthly EOR management fee in USD.

work_schedule_assignment_settingsenumOptional

Work schedule assignment setting.

probation_period_type_for_definiteenum or nullOptional

Probation period type for definite contracts.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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