Employees

The employee endpoints enable you to create, retrieve, update and delete employees at a given location.

Introduction

Create/retrieve employees

/locations/{location_id}/employees/v1

This endpoint enables you to create and retrieve employees at location location_id.

Update/delete employee

/locations/{location_id}/employees/{employee_id}/v1

This endpoint enables you to update or delete employee employee_id at location location_id.

Employee history

/locations/{location_id}/employees/history/v2?transponder_id=12345678&transponder_id_source=globus&at=2022-01-07T10:44:12Z

This endpoint retrieves the employee associated with a specific transponder_id at a given location_id. Because transponder IDs may vary in zero-padding depending on their origin, it is recommended to specify the source using the transponder_id_source parameter. Omitting the transponder_id_source may result in ambiguous mappings between transponder IDs and employees, potentially leading to a conflict error (HTTP 409).

If an employee uses an imprinted transponder ID (a 6-character value mapped to an internal transponder ID), you may provide either the imprinted ID or the corresponding internal ID.

Since transponders can be reassigned to different employees over time, you can also use the at parameter to specify the desired point in time for the lookup.

Reference Docs