MLM API - Endpoint Employees v1.0 will be retired per 1-7-2023

[#1]

In September 2020, we added a new version of the Employees endpoint to the MLM API.

For details on v1 versus v2, please read this article.

Per the first of July 2023, we are moving the old version 1.0 from deprecated to retired. This means we will stop the availability of the endpoint. 

If you still use this endpoint, we urge you to start using the Employees v2 version.

Q1: How do I know which version I use?

A1: If you don't use header variable Accept-version with version 2.0, you are using the v1.0

This indicates usage of v2.0

Q2: What are the differences between v1.0 en v2.0?

A2: All fields available in v1.0 are available on v2.0, except for 1 field. This concerns the personId field. The personId in v1.0 is the id field in v2.0. See below for an overview:

Field	v1.0	v2.0
id	mutkey of employee	personNumber (elementnr: 10519680)
personId	personNumber (elementnr: 10519680)	not available

The mutkey of the employee is not available in v2.0. To identify employees, the personId and personcode can be used