---
title: "List of employments with additional entities"
method: GET
path: "/v2/providers/employers/{employerId}/employees/employments/comprehensive"
tags: ["Employment"]
---

# List of employments with additional entities

`GET /v2/providers/employers/{employerId}/employees/employments/comprehensive`

__Activity name :__ <a href="https://developer.loket.nl/Activities/GetEmploymentsComprehensiveByEmployerId" target="_blank">GetEmploymentsComprehensiveByEmployerId</a>

__Availability:__ This is endpoint is available for the Loket application only. It is not available for external parties

Get a list of employments for an employer.  With this version we introduced the "Comprehensive" resource which contains additional entities. 

This endpoint only returns the employments that meet the filter settings set at the user level. Note that filter settings are set for a user <-> employer <-> client combination.

## Path parameters

- `employerId` string, uuid, required

## Query parameters

- `referenceDate` string, date
- `removeEmptyLines` boolean
- `includeHistoricAndFutureData` boolean
- `filter` string
- `orderBy` string
- `pageNumber` integer
- `pageSize` integer

## Headers

- `Authorization` string, required
- `Accept` string, required

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/loket/apis/loket-api.md) · [All operations](https://skmtc.net/loket/apis/loket-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loket/loket-api/revisions/32d1693f8db8/schema)