---
title: "List of employment version numbers"
method: GET
path: "/v2/providers/employers/{employerId}/employees/employments/lastmodifiedversionnumbers"
tags: ["Last modified version numbers"]
---

# List of employment version numbers

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

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/{employerId}/employees/employments/lastmodifiedversionnumbers`
- Auth: none required

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

This endpoint is similar to the GetEmployerLastModifiedVersionNumbersByUser endpoint described above. Please check out that description for required context.

In addition to the version on employer level, this endpoint allows you to check if this employment has any changes since your last synchronization. Consequently, this endpoint may be used to further decrease the amount of required calls when performing a synchronization.

As can be seen in the set of 'underlying' tables, also changes in Employee information corresponding to the Employment is reflected in the version number.

**How to use**

*Recommended usage*
* Perform all recommended steps in the description of the employer version number endpoint
* Use the exact SAME filter parameter to this endpoint. The resulting list will contain only the employment for which changes have occured since your last synchronization.

## Path parameters

- `employerId` string, uuid, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageNumber` integer
- `pageSize` integer

## Headers

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

## Response `200`

OK

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `totalSize` integer: Total number of records, taking into account the given filter.
  - `pageSize` integer: Number of records in the response
  - `totalPages` integer: Number of pages available
  - `currentPage` integer: Current page returned in the response
  - `version` Version
    - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available
    - `resourceVersion` string, date: The resource version of the object in the response
  - `messages` object[]
    - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages)
    - `description` string: Describes the message
    - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity
    - `code` integer: Identifying code for the message
    - `properties` string[]: An array that can contain additional information
  - `_embedded` VersionObject[]
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `lastModifiedVersionNumber` integer: The version number reflects the latest version of all predefined underlying tables of this employer/employment.

## Other responses

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

---

[API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)