Discussions

We are rolling out automated HR workflows in Q2 2026. One of the first production use cases depends on reading bonus values from Personio.

The endpoint documentation (https://developer.personio.de/reference/get_v2-compensations) states the response includes "base salary (excluding proration), hourly, one time compensation, recurring compensation, and bonuses".

In practice, however, /v2/compensations returns only FIXED_SALARY, HOURLY_SALARY, and benefit-type RECURRING records. We verified this against:

Single employee with person.id filter, multiple date ranges (Jan 2025, Jan 2026, March 2026, default current month) — always the same three non-bonus records.

Company-wide query with no filters at all — 100 records returned, none of category ONE_TIME, none with a bonus-related type name, even though /v2/compensations/types enumerates 23 types.

The Goal bonus and other Compensation Components clearly visible in the UI under Salary > Compensation components are entirely absent from the API response.

A previous community thread on this exact topic was closed without resolution: https://developer.personio.de/discuss/670e6bd6d79e740060cc8bac

Could you please confirm:

• Whether this is a documentation error (the response actually omits one-time and bonus categories by design) or an API gap.
• If a gap — what is the expected fix path and timeline?
• If by design — is there a separate endpoint, scope, or beta program that exposes bonus records?
• Happy to share probe outputs and request signatures privately for triage.