curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/employees/{external_id} \
  --header 'Authorization: Bearer <token>'
{
  "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "assigned_position": "Python Developer",
  "assigned_position_id": "b3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "active": true,
  "low_data_availability": false,
  "organisational_unit": "e4d3a59c-2f37-4a3f-9318-9d75e0e7a8f1",
  "working_history": [
    {
      "start_date": "2018-09-05",
      "end_date": "2020-06-17",
      "company": "TechWolf BV",
      "job_title": "HR Manager",
      "job_description": "Manage the HR department and perform workforce planning"
    }
  ],
  "education_history": [
    {
      "start_date": "2016-09-05",
      "end_date": "2018-09-05",
      "school": "Harvard University",
      "degree_name": "Master in Human Resources Management"
    }
  ],
  "languages": [
    {
      "language": "nl",
      "level": 2
    }
  ],
  "desired_functions": [
    {
      "title": "Business Analyst",
      "importance": 0.5
    },
    {
      "title": "Police Officer",
      "importance": 1
    }
  ],
  "non_desired_functions": [
    "<any>"
  ],
  "last_updated": "2021-01-21T17:32:28Z",
  "custom_properties": [
    {
      "property_name": "creation_date",
      "property_value": "2020-03-07"
    },
    {
      "property_name": "language",
      "property_value": "de"
    }
  ],
  "location": {
    "lat": 51.0216707,
    "lng": 3.6887328
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

external_id
string
required

The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

Query Parameters

include
enum<string>[]

Additional entity attributes that will be included in the response body. This query parameter can be added multiple times to include more attributes.

Example:
["custom_properties"]

Response

200
application/json

OK

Default structure for Employee data. Nested structure for Employee data. Reduced structure for Employee data.