Employment HeroRetrieve the list of policies visible to a specific employee within the organisation, including their individual acknowledgement status. Results include policies shared directly to the employee, via their team, work location, employing entity, or employment type.
https:/api.employmenthero.com/api/v1/organisations/:organisation_id/employees/:employee_id/policiesPath Parameters
The ID of the organisation.
The ID of the employee whose policies to retrieve.
Query Parameters
Current page index
11Number of items per page
20100Response Body
A paginated list of policies visible to the specified employee, including their individual acknowledgement status.
Unique identifier of the policy.
Name of the policy.
Publication status of the policy.
Whether acknowledgement of this policy is mandatory.
Whether the policy is archived.
Whether the policy content is an uploaded document.
The member's acknowledgement status for this policy.
ISO 8601 timestamp when the member acknowledged the policy.
Due date for acknowledgement in YYYY-MM-DD format.
ISO 8601 timestamp when the policy was created.
ISO 8601 timestamp when the policy was last updated.
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/policies" \ -H "Authorization: Bearer AUXJ3123xyrj123fdsjkl124aAJKQ"Response
{ "data": { "items": [ { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Full-Disk Encryption Policy", "status": "Published", "mandatory": true, "archived": false, "uploaded_policy": true, "member_status": "outstanding", "acknowledged_at": null, "due_date": "2025-08-01", "created_at": "2025-01-15T09:00:00.000Z", "updated_at": "2025-06-01T14:30:00.000Z" }, { "id": "c3d4e5f6-a7b8-9012-cdef-123456789012", "name": "Work From Home Agreement", "status": "Published", "mandatory": false, "archived": false, "uploaded_policy": true, "member_status": "non_mandatory", "acknowledged_at": null, "due_date": null, "created_at": "2025-03-10T11:00:00.000Z", "updated_at": "2025-03-10T11:00:00.000Z" } ], "page_index": 1, "item_per_page": 20, "total_items": 2, "total_pages": 1 }}