Retrieve a list

Returns a filtered list of absence definitions.

Endpoint details

https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/absence-definitions

Headers: Authorization: Bearer {token}, User-Agent: {agent} Scope: connector-protimeapi-absence-definitions.read

Response properties

Field	Type	Required	Writable	Description
changeVersion	string	—	Read-only	Property to indicate the order of changes.
id	integer	—	Read-only	Internal unique identifier for the absence definition.
name.default	string	—	Read-only	Default name value of the absence definition.
name.translations	object	—	Read-only	A list of translated names of the definition by language code.
code	string	—	Read-only	An absence code used for this definition.
friendlyName.default	string	—	Read-only	Default friendly name value for this definition shown to users.
friendlyName.translations	object	—	Read-only	A list of translated friendly names by language code.
friendlyCode.default	string	—	Read-only	Default friendly code value for this definition shown to users.
friendlyCode.translations	object	—	Read-only	A list of translated friendly codes by language code.
allowedDurations	array	—	Read-only	List of allowed durations (Unknown, FullDay, HalfDay, Interval, Duration).
isEnabled	boolean	—	Read-only	Indicates if the absence definition is enabled in myProtime.
isReasonForClocking	boolean	—	Read-only	Indicates if this absence can be used as a reason for clockings.
absenceGroup.id	integer	—	Read-only	The ID of the associated absence group.

Filters

This endpoint does not require any filter parameters. It returns all absence definitions in the system.

External references

The endpoint supports custom external references. See the external references page for details.

The following collections are supported for this endpoint:

Collection	Predefined	Custom
absence-groups	Not available	Supported

Error responses

Status	Condition
401	Missing or invalid access token, or insufficient scope
414	Request URI too long (continuation token)

Examples

Retrieving all absence definitions

https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/absence-definitions