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
      • POSTCreate an EOR contract
      • GETRetrieve EOR Contract Details
      • PATCHUpdate EOR Contract
    • PATCHProfiles
LogoLogo
SupportDeel Home
EndpointsEor Contract

Retrieve EOR Contract Details

GET
/eor/contracts/:contract_id/details
GET
/rest/v2/eor/contracts/:contract_id/details
$curl https://api.letsdeel.com/rest/v2/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  "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 basic contract information and associated employment costs for a specific EOR contract. Token scopes: contracts:read

Was this page helpful?
Previous

Update EOR Contract

Next
Built with

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/

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

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/