Unauthorized error when calling Employments endpoint

Hi,

We are experiencing an authorization issue when calling the Employments endpoint, despite the API user having all required permissions.

API call GET https://api.personio.de/v2/persons/24917735/employments
Response

{
   "personio_trace_id": "5b4bdc2a-ca75-46f8-904f-ec3850d4afc9",
   "timestamp": "2026-01-07T10:14:38Z",
   "errors": [
     {
       "title": "Unauthorized Request",
       "detail": "The request cannot be completed due to authorization restrictions."
     }
   ]
 }

What we have already verified

The API key is valid and created under Settings → Integrations → API credentials
The API key has Person API – Read access
The user who created the API key:
- Has an active employee role
- Has view access to employee data, including employment-related sections
Other Person API endpoints (e.g. /persons) work correctly with the same API key

⠀Despite this, the /employments endpoint consistently returns an Unauthorized Request.

Questions
1 Are there additional or non-obvious permissions required specifically for the /employments endpoint?
2 Is access to this endpoint restricted by feature flags, rollout status, or company-specific settings?
3 Is there anything in the provided personio_trace_id that explains why authorization is denied?

We’d appreciate it if you could check the trace ID on your side and let us know what is blocking access.

Thanks in advance.

Kind regards,

Harm
DataSpark