Calculate Employee Costs Globally

POST

/eor/employment_cost

POST

/rest/eor/employment_cost

$ curl -X POST https://api.letsdeel.com/rest/eor/employment_cost \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "data": {
>     "salary": 60000,
>     "country": "Germany",
>     "currency": "EUR",
>     "state": "Bavaria",
>     "benefits": [
>       {
>         "provider_id": "123",
>         "plan_id": "basic-health"
>       }
>     ],
>     "country_code": "DE",
>     "salary_period": "ANNUALLY"
>   }
> }'

1 {
2   "costs": [
3     {
4       "name": "Base Salary",
5       "amount": "60000",
6       "country": "Germany",
7       "frequency": "annually",
8       "country_code": "DE"
9     },
10     {
11       "name": "Health Insurance",
12       "amount": "3000",
13       "country": "Germany",
14       "frequency": "annually",
15       "country_code": "DE"
16     }
17   ],
18   "salary": "60000",
19   "country": "Germany",
20   "currency": "EUR",
21   "deel_fee": "500",
22   "frequency": "annually",
23   "total_costs": "63500",
24   "country_code": "DE",
25   "benefits_data": [
26     {
27       "name": "Health Insurance",
28       "plan": "basic-health",
29       "amount": "3000",
30       "fee_amount": "0"
31     }
32   ],
33   "employer_costs": "3500",
34   "additional_data": {
35     "additional_notes": [
36       "Severance accrual not included in calculation."
37     ]
38   },
39   "severance_accural": "0",
40   "employer_annual_costs": "3000"
41 }

Calculates the total employment cost for an EOR arrangement in a specified country, returning a breakdown that includes employer costs, benefits, platform fees, and severance accrual.

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/

Request

This endpoint expects an object.

dataobjectRequired

Response

Successfully calculated employee costs.

costslist of objectsOptional

salarystringOptional

The base salary for the employee.

countrystringOptional

The country where the employee is based.

currencystringOptional

The currency used for cost calculation.

deel_feestringOptional

The Deel fee for managing the employee.

frequencystringOptional

Frequency of the salary payment (e.g., monthly).

total_costsstringOptional

Total employment costs.

country_codestringOptional

ISO Alpha-2 code of the country.

benefits_datalist of objectsOptional

employer_costsstringOptional

Costs incurred by the employer.

additional_dataobjectOptional

severance_accuralstringOptional

Severance accrual costs.

employer_annual_costsstringOptional

Costs incurred by the employer for cost items with an annual payment frequency.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

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