Employment HeroThis endpoint retrieves a list of the complete employment history for a specific employee.
https:/api.employmenthero.com/api/v1/organisations/:organisation_id/employees/:employee_id/employment_historiesPath Parameters
The ID of the organisation to retrieve
The ID of the employee to retrieve
Query Parameters
Current page index
11Number of items per page
20100Response Body
A hash with a data property that contains an array of up to the limit of employment history records. Each entry in the array is a separate employment history object. If there is no more employment history, the resulting array will be empty.
Unique identifier for the object.
The title of employee
The start date of employment history
The end date of employment history
The employment type of employee. Valid types depend on the employee's region. Common values: Full-time, Part-time, Casual
The contract type of employee
The industry standard job title
Current page index
11Number of items per page
20100Total items
Total pages
Example
curl -X GET \ "https://api.employmenthero.com/api/v1/organisations/:organisation_id/employees/:employee_id/employment_histories" \ -H "Authorization: Bearer AUXJ3123xyrj123fdsjkl124aAJKQ"Response
{ "data": { "items": [ { "id": "bf9c12e1-b40b-4fa9-abcb-d824e5cb3654", "title": "Grad Developer", "start_date": "2025-03-01T00:00:00+00:00", "end_date": "2026-08-09T00:00:00+00:00", "employment_type": "Full-time", "contract_type": "Permanent", "industry_standard_job_title": "Software Engineer" } ], "page_index": 1, "item_per_page": 20, "total_items": 1, "total_pages": 1 }}