Discussions

Ask a Question
Back to all

Missing error documentation and inconsistent error response formats in Personio API V2

Hello,

I am currently integrating with the Personio API (specifically the attendance endpoints) and noticed an inconsistency between the documentation and the actual API responses.

The documentation references the error definitions page:
https://developer.personio.de/reference/errors
However, this page appears to be missing or not accessible.

Additionally, the endpoint documentation (e.g. https://developer.personio.de/reference/get_v2-attendance-periods-id) describes error responses in the following format:

{
"title": "Access denied",
"detail": "Access denied to perform attendance period operations.",
"type": "https://developer.personio.de/reference/errors#common.forbidden_response"
}

However, the actual responses returned by the API differ significantly. For example:

{
"id": "93c06d6b-f00e-4891-8026-03c1c41676c6",
"status": "403",
"title": "Blocking attendance ... Minimum break duration of PT15M was not respected.",
"type": "MINIMUM_BREAK_RULE_VIOLATION"
}

Because of this discrepancy, I would like to ask:

Is the error documentation page available at a different location?
Is there an up-to-date and complete list of possible error type values (e.g. MINIMUM_BREAK_RULE_VIOLATION)?
?

Thank you very much for your support.

Best regards,
Fabian Tryba