Retrieve Seniority Levels | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/lookups/seniorities"
querystring = {"is_eor_contract":"true"}
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers, params=querystring)
print(response.json())

{
  "data": [
    {
      "id": 1,
      "name": "Junior (Individual Contributor Level 1)",
      "level": 1
    },
    {
      "id": 2,
      "name": "Mid (Individual Contributor Level 2)",
      "level": 2
    },
    {
      "id": 3,
      "name": "Senior (Individual Contributor Level 3)",
      "level": 3
    },
    {
      "id": 4,
      "name": "Lead (Team Lead Level 1)",
      "level": 4
    },
    {
      "id": 5,
      "name": "Manager (Manager Level 2)",
      "level": 5
    },
    {
      "id": 6,
      "name": "Director (Director Level 3)",
      "level": 6
    },
    {
      "id": 7,
      "name": "VP (Vice President Level 4)",
      "level": 7
    },
    {
      "id": 8,
      "name": "C-Level (Executive Level 5)",
      "level": 8
    }
  ]
}

Retrieve a list of predefined seniority levels for roles in the Deel platform, including their names, hierarchical levels, and unique identifiers.

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/

Query parameters

is_eor_contractbooleanOptionalDefaults to true

when true, exclude C-level seniorities for EOR contracts. Set to false to return all seniorities

Response

Successful operation.

datalist of objects or null

List of predefined seniority levels supported by the Deel platform.

1	{
2	"data": [
3	{
4	"id": 1,
5	"name": "Junior (Individual Contributor Level 1)",
6	"level": 1
7	},
8	{
9	"id": 2,
10	"name": "Mid (Individual Contributor Level 2)",
11	"level": 2
12	},
13	{
14	"id": 3,
15	"name": "Senior (Individual Contributor Level 3)",
16	"level": 3
17	},
18	{
19	"id": 4,
20	"name": "Lead (Team Lead Level 1)",
21	"level": 4
22	},
23	{
24	"id": 5,
25	"name": "Manager (Manager Level 2)",
26	"level": 5
27	},
28	{
29	"id": 6,
30	"name": "Director (Director Level 3)",
31	"level": 6
32	},
33	{
34	"id": 7,
35	"name": "VP (Vice President Level 4)",
36	"level": 7
37	},
38	{
39	"id": 8,
40	"name": "C-Level (Executive Level 5)",
41	"level": 8
42	}
43	]
44	}

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

Authentication

Authentication

Query parameters

Response

Errors

Authentication