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",
  "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.

Available options:
custom_properties
Example:
["custom_properties"]

Response

200
application/json
OK

Default structure for Employee data.

​
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"

​
last_updated
string
required

Timestamp of the last update to this entity.

Example:

"2021-01-21T17:32:28Z"

​
location
object

A geographic location, expressed in latitude and longitude. This can represent a home address, an office location... Each entity is limited to having a single location. To get the latitude and longitude for a given address, you can use the Google Maps Geocoding API or a predefined lookup table (for example by zip code). If location is present in matching or filters, it will act as an override for geo-distance calculations.

​
assigned_position
string | null

Job title of the Employee's assigned position.

Required string length: 1 - 255
Example:

"Python Developer"

​
assigned_position_id
string

external_id of the Job the Employee is assigned to.

Required string length: 1 - 100
Example:

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

​
active
boolean | null
default:true

The Employee will not be used in matching if active is false. This is useful when an Employee is being phased out.

Example:

true

​
low_data_availability
boolean

Flag indicating whether sufficient data is available for qualitative skill inference for a given entity.

Example:

false

​
organisational_unit
string | null

The external ID of the Organisational Unit the Employee is assigned to.

Required string length: 1 - 255
Example:

"e4d3a59c-2f37-4a3f-9318-9d75e0e7a8f1"

​
working_history
object[] | null

The working history of an Employee. It is recommended to add these through the Skill Event endpoints as to not overwrite any existing Working History events.

Default structure for work experiences listed for an Employee.

​
education_history
object[] | null

The education history of an Employee. It is recommended to add these through the Skill Event endpoints as to not overwrite any existing Education History events.

Default structure for education history listed for an Employee.

​
languages
object[] | null

List of ISO 639-1 codes for languages spoken by the Employee, combined with the proficiency level. The proficiency levels go from 1 (elementary proficiency) to 5 (native proficiency). If the level is omitted, the default proficiency level of 2 is used.

​
desired_functions
object[] | null

List of desired functions of the Employee. Elements consist of a title and an importance. The title can be either a single-line string or free text. The desired function is only processed and stored when the desired function is recognized by TechWolf AI.

Default structure for a (non) desired function of an Employee.

Example:
[
  {
    "title": "Business Analyst",
    "importance": 0.5
  },
  {
    "title": "Police Officer",
    "importance": 1
  }
]
​
non_desired_functions
any[] | null
deprecated

List of non-desired functions of the Employee. Elements consist of a title and an importance. The title can be either a single-line string or free text. The non-desired function is only processed and stored when the non-desired function is recognized by TechWolf AI.

Was this page helpful?