Employee Tables

List employee's employment history.

Returns a list of employment history entries for a given employee.

Each employment entry includes the working pattern assigned to this employee. To learn more about working patterns, see How to work with Working patterns.

Required permissions

  • For all the employment table entries: People's Data > People's fields > Employment > View history, and View on the category or required fields.

  • For the current effective employment entry only: People's Data > People's fields > Employment > View.

  • For the employees: People's Data > Access data for: Make sure the employees are in the list. Employees that are not listed and were specifically requested will be listed under `errors` in the response.

get/people/{id}/employment

Request

  • Base URL
    https://api.hibob.com/v1
  • URL
    https://api.hibob.com/v1/people/{id}/employment
  • Auth
    • HTTP basic
    • or HTTP bearer

Path parameters

idstring required

employee id

Query parameters

includeArchivedboolean

By default (false), archived columns are excluded from the response. When set to true, archived columns are included.

Response

List of employment history entries.

Example response

{
  "values": [
    {
      "actualWorkingPattern": {
        "workingPatternType": "hourly",
        "days": {
          "monday": 9,
          "tuesday": 9,
          "wednesday": 9,
          "thursday": 9,
          "friday": 9
        },
        "hoursPerDay": 9
      },
      "siteWorkingPattern": {
        "workingPatternType": "hourly",
        "days": {
          "monday": 9,
          "tuesday": 9,
          "wednesday": 9,
          "thursday": 9,
          "friday": 9
        },
        "hoursPerDay": 9
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.