Employees

List all employees

get/employees

Query parameters

employeeNamestring

Filter employees by name

Example:John Doe

Filter employees by name

departmentIdstring

Filter employees by department ID

Example:123

Filter employees by department ID

skillsstring

Filter employees by skills according to skillsFiltering

Example:JavaScript,React

Filter employees by skills

skillsFiltering'ANY' | 'ALL'

If more than one skill is passed, return either employees with any of the skills (ANY) or with all of them (ALL)

Example:ALL

How to match employee skills

salaryFromstring

Minimum salary amount

Example:5000

Minimum salary amount

salaryTostring

Maximum salary amount

Example:10000

Maximum salary amount

Response

Successful operation

idinteger required
nationality'US' | 'UK' | 'FR' | 'DE' | 'NL' | 'PL' | 'IT' | 'ES' required

Nationality of employee as an ISO 3166-1 alpha-2 country code

departmentstring required
keycardIdstring required
accountstring required
salarynumber required

Monetary value in EUR

officestring[] required
firstNamestring required
lastNamestring required
titlestring required
contractType'CONTRACT' | 'PERMANENT' required

Type of employment contract

emailstring email required

Email address string

hiredAtstring date-time required

ISO 8601 date-time string

expiresAtstring date-time required

ISO 8601 date-time string

skillsSkill[] required
biostring required
imgURLstring

Example response

[
  {
    "id": 1234,
    "nationality": "DE",
    "department": "Marketing",
    "keycardId": "KC-9876",
    "account": "DE89 3704 0044 0532 0130 00",
    "salary": 75000,
    "office": [
      "Berlin",
      "HQ"
    ],
    "firstName": "Hans",
    "lastName": "Schmidt",
    "title": "Senior Developer",
    "contractType": "PERMANENT",
    "email": "hans.schmidt@itcorpo.com",
    "hiredAt": "2020-01-15T00:00:00.000Z",
    "expiresAt": "2025-01-14T23:59:59.999Z",
    "personalInfo": {
      "age": 35,
      "phone": "+49 123 456789",
      "email": "hans.schmidt@gmail.com",
      "dateOfBirth": "1988-05-20T00:00:00.000Z",
      "address": {
        "street": "Alexanderplatz 1",
        "city": "Berlin",
        "country": "Germany"
      }
    },
    "skills": [
      "JavaScript",
      "TypeScript",
      "React"
    ],
    "bio": "Experienced developer with focus on frontend technologies",
    "imgURL": "hans-schmidt-profile.jpg"
  }
]

Changes