# Personio API changelog We check Personio's changelog and OpenAPI spec every day, because we run production integrations on the Personio API. This page lists the 463 changes we have recorded since monitoring started on 26 March 2026, newest first. Our last successful check was on 27 September 2026. We are on it; until then this page may miss the newest changes. **In short:** 0 breaking changes and 3 deprecations in the Personio API in the last 90 days. The latest: “Deprecated” (4 December 2026). - [Official Personio changelog](https://developer.personio.de/changelog) - [Personio OpenAPI spec](https://raw.githubusercontent.com/personio/api-docs/master/personio-personnel-data-api-oa3.yaml) - [RSS feed: Personio API changes](https://seamless.engineering/api-changelog/personio/rss.xml) - [All Personio integrations](https://seamless.engineering/integrations/personio/) ## Personio API changes Labels are assigned automatically. Check the vendor's note before planning work around an entry. ### December 2026 - **Deprecated** (Deprecation, 4 Dec 2026): query-string credentials on POST /v1/auth: Query-string credentials on POST /v1/auth endpoint deprecated with removal date 2026-12-04; integrations must migrate to body-based authentication. ### October 2026 - **Deprecated** (Deprecation, 1 Oct 2026): query-string credentials on POST /v1/auth: Query-string based credentials authentication method on POST /v1/auth is deprecated with removal scheduled for 2026-12-04; integrations using this method must migrate to header-based authentication. ### September 2026 - **Update of the TLS Certificate** (Other, 15 Sept 2026): Personio is updating TLS certificates from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but certificate pinning implementations may need updates. - **Recruiting API is Generally Available** (New feature, 14 Sept 2026): Beta flag removed from Recruiting API endpoints, indicating the API is now production-ready and supported. ### August 2026 - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 30 Aug 2026): V1 Attendances and Projects endpoints are deprecated in favor of V2 versions with final removal date of August 30, 2026, requiring migration. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 15 Aug 2026): Beta flag removed from Cost Center, Org Unit and Workplace API endpoints, marking them as generally available and production-ready. - **Update of the TLS Certificate** (Other, 13 Aug 2026): TLS certificate has been updated, which may require clients to update their certificate trust stores to maintain secure connections. - **Recruiting API is Generally Available** (New feature, 9 Aug 2026): Recruiting API has been removed from beta status and is now generally available, providing stable endpoints for recruitment functionality. ### July 2026 - **Jobs and Salary Bands Available** (New feature, 15 Jul 2026): New Jobs and Salary Bands APIs have been made available, providing new endpoints for managing job and compensation data. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 6 Jul 2026): The created_at field response format changed to return UTC values effective 06.07.2026; integrations consuming this field should handle the format change. - **Job reference now available on Employment** (New feature, 2 Jul 2026): The Employment endpoint now includes a job reference field, providing additional context linking employment records to jobs. - **Jobs and Salary Bands Available** (New feature, 2 Jul 2026): New Jobs and Salary Bands functionality has been added to the API, expanding available endpoints and data access. ### June 2026 - **Job reference now available on Employment** (New feature, 29 Jun 2026): The Employment endpoint now includes a job reference field, adding new data that can be queried without breaking existing functionality. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 24 Jun 2026): The created_at field in document list responses will be changed to return UTC timestamps as of 2026-07-06, affecting document management integrations. - **Update of the TLS Certificate** (Other, 19 Jun 2026): TLS certificate on API endpoints updating from RSA 2048-bit to ECDSA P-256 in Q3 2026; no action required for most integrations. - **Recruiting API is Generally Available** (New feature, 18 Jun 2026): Recruiting API beta flag removed and endpoints are now generally available, indicating API maturation and stability. - **Recruiting API is Generally Available** (New feature, 16 Jun 2026): Recruiting API beta flag removed and endpoints are now generally available, marking graduation from beta status. - **Jobs and Salary Bands Available** (New feature, 15 Jun 2026): New endpoints for Jobs and Salary Bands have been added to the API. - **Job reference now available on Employment** (New feature, 13 Jun 2026): New job reference field added to Employment endpoint, providing additional context linking employments to jobs. - **Jobs and Salary Bands Available** (New feature, 13 Jun 2026): New Jobs and Salary Bands endpoints have been added to the API, expanding available data access. - **Job reference now available on Employment** (New feature, 12 Jun 2026): Employment objects now include a job reference field, providing additional relationship data between employments and jobs. - **Jobs and Salary Bands Available** (New feature, 12 Jun 2026): New Jobs and Salary Bands endpoints and functionality have been added to the API, expanding available data access. - **Update of the TLS Certificate** (Other, 10 Jun 2026): TLS certificate being updated from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but connections should be validated for compatibility. - **Job reference now available on Employment** (New feature, 9 Jun 2026): Job reference field is now exposed on Employment endpoint responses. - **Jobs and Salary Bands Available** (New feature, 9 Jun 2026): New Jobs and Salary Bands endpoints have been added to the API. - **Recruiting API is Generally Available** (New feature, 9 Jun 2026): Recruiting API has graduated from beta to general availability with beta flag removed from all recruiting endpoints. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 4 Jun 2026): V1 endpoints for Attendances and Projects are deprecated with extended deprecation deadline; users should migrate to newer versions. - **Job reference now available on Employment** (New feature, 3 Jun 2026): Employment objects now include a job reference field. - **Jobs and Salary Bands Available** (New feature, 3 Jun 2026): New Jobs and Salary Bands features have been added to the API. - **Deprecated** (Deprecation, 1 Jun 2026): query-string credentials on POST /v1/auth: Query-string credentials for the authentication endpoint are deprecated, signaling a move away from this authentication method toward more secure alternatives. ### May 2026 - **Update of the TLS Certificate** (Other, 30 May 2026): TLS certificate upgrade from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations unaffected but certificate pinning implementations may need updates. - **Recruiting API is Generally Available** (New feature, 29 May 2026): Recruiting API beta flag removed and endpoints now in GA status, indicating API maturity and production-ready status. - **Job reference now available on Employment** (New feature, 24 May 2026): Job reference field has been added to Employment endpoint responses. - **Update of the TLS Certificate** (Other, 20 May 2026): Personio is updating TLS certificates from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but certificate pinning may need updates. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 19 May 2026): Beta flag removed from Cost Center, Org Unit, and Workplace endpoints, which are now generally available. - **Recruiting API is Generally Available** (New feature, 19 May 2026): Recruiting API beta flag has been removed and endpoints are now generally available, indicating API stability and maturity. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 15 May 2026): Beta flags removed from Cost Center, Org Unit, and Workplace APIs; these endpoints are now generally available. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 10 May 2026): V1 endpoints for Attendances and Projects API are deprecated with extended deprecation deadline; users must migrate to V2 endpoints. - **Job reference now available on Employment** (New feature, 6 May 2026): The Employment endpoint now returns a job reference field, providing additional context linking employment records to job data. - **Jobs and Salary Bands Available** (New feature, 6 May 2026): New endpoints or fields have been added to expose Jobs and Salary Bands data through the API. - **Deprecated** (Deprecation, 1 May 2026): query-string credentials on POST /v1/auth: Query-string based credentials for POST /v1/auth are deprecated with removal scheduled for 2026-12-04; integrations should migrate to header-based authentication. ### April 2026 - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 24 Apr 2026): Attendance Periods API V2 now returns absolute URLs in pagination links instead of relative URLs. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 24 Apr 2026): The created_at field in document list response will change its return format to UTC, effective 2026-07-06, which could break integrations expecting a different timezone format. - **Hiring Team Array in Recruiting API** (New feature, 14 Apr 2026): New hiring_team array added to Recruiting API responses for applications and jobs, listing all persons responsible for each resource. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 10 Apr 2026): Cost Center, Org Unit, and Workplace APIs have been promoted from beta to general availability with beta flag removed. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 9 Apr 2026): Attendances and Projects V1 endpoints are marked for deprecation, requiring clients to migrate to V2 endpoints before removal. - **Fixed Missing Termination Fields in Employments** (Bug fix, 9 Apr 2026): Fixed issue where three termination fields were missing from GET /v2/persons/{person_id}/employments responses; credential refresh required to access fixed data. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 9 Apr 2026): V2 Projects and Project Members endpoints now expose advanced Project attributes, subproject support via parent_project.id, and new endpoints for managing employee assignment to projects. - **New validations to project tracking** (Other, 9 Apr 2026): Introduced new validations to project tracking APIs to improve data integrity and prevent accidental data issues in attendance management. - **Office to Workplace renaming update** (Other, 9 Apr 2026): Renamed Offices to Workplaces to better reflect that employees may work in non-office locations or remotely. - **Reporting API V2 Endpoints** (New feature, 9 Apr 2026): New V2 endpoints for the Reporting API have been released, providing updated reporting capabilities alongside existing V1 endpoints. - **Status filter in list persons endpoint** (New feature, 9 Apr 2026): A new status filter parameter has been added to the list persons endpoint, enabling more granular filtering capabilities without breaking existing queries. - **Deprecated** (Deprecation, 4 Apr 2026): query-string credentials on POST /v1/auth: Query-string credentials for POST /v1/auth endpoint are deprecated with removal scheduled for December 4, 2026. - **Deprecated** (Deprecation, 1 Apr 2026): query-string credentials on POST /v1/auth: Query-string credentials authentication method on POST /v1/auth is deprecated with removal scheduled for 2026-12-04, requiring migration to alternative auth methods. ### March 2026 - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 20 Mar 2026): Beta flags removed from Cost Center, Org Unit, and Workplace APIs, indicating these endpoints are now production-ready. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 20 Mar 2026): V1 endpoints for Attendances and Projects are deprecated with an extended deprecation deadline; integrations should migrate to V2 endpoints. - **Job reference now available on Employment** (New feature, 15 Mar 2026): New job reference field added to Employment endpoints, providing additional data about associated jobs. - **Reporting API V2 Endpoints** (New feature, 6 Mar 2026): New Reporting API V2 endpoints have been introduced with access to new compensation and attendance attributes not available in V1, including target earnings, total payout, goal bonus, bonus payout, and project/location tracking. - **Status filter in list persons endpoint** (New feature, 4 Mar 2026): New status query parameter added to GET /v2/persons endpoint for filtering by employment status. ### February 2026 - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 13 Feb 2026): Cost Center, Org Unit, and Workplace APIs removed beta flag and are now generally available; endpoints are stable for production use. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 13 Feb 2026): Attendances and Projects V1 endpoints are deprecated with extended deprecation deadline; integrations must migrate to V2 endpoints before removal date. - **Reporting API V2 Endpoints** (New feature, 6 Feb 2026): New reporting API v2 endpoints introduced enabling access to reports and new compensation/attendance attributes not available in v1. - **Reporting API V2 Endpoints** (New feature, 4 Feb 2026): New reporting API v2 introduced with access to analytics 2.0 platform reports and new compensation/attendance attributes not available in v1. - **Deprecated** (Deprecation, 1 Feb 2026): query-string credentials on POST /v1/auth: Query-string credentials authentication method on POST /v1/auth endpoint is deprecated with removal scheduled for 2026-12-04; users should migrate to header-based authentication. - **Reporting API V2 Endpoints** (New feature, 1 Feb 2026): New Reporting API V2 endpoints introduced with access to new analytics 2.0 reports and compensation/attendance attributes not available in V1. ### January 2026 - **Recruiting API is Generally Available** (New feature, 17 Jan 2026): Recruiting API has removed beta flag and is now generally available; endpoints can be considered stable for production use. - **Update of the TLS Certificate** (Other, 17 Jan 2026): TLS certificate on API endpoints will be updated from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but certificate pinning implementations may be affected. - **Update of the TLS Certificate** (Other, 16 Jan 2026): TLS certificate will be updated from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but clients should verify compatibility. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 15 Jan 2026): Beta flag removed from Cost Center, Org Unit and Workplace APIs making them generally available for production integrations. - **Recruiting API is Generally Available** (New feature, 15 Jan 2026): Recruiting API has been promoted from beta to generally available status, removing beta flag from all endpoints. - **Status filter in list persons endpoint** (New feature, 15 Jan 2026): New status query parameter added to GET /v2/persons endpoint enabling filtering by employment status. - **Update of the TLS Certificate** (Other, 14 Jan 2026): Personio is updating TLS certificates from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but certificate validation logic may need verification. - **Recruiting API is Generally Available** (New feature, 13 Jan 2026): Recruiting API beta flag has been removed and endpoints are now generally available, indicating API maturity and stability guarantees. - **Recruiting API is Generally Available** (New feature, 8 Jan 2026): Recruiting API beta flag removed and endpoints now generally available, indicating API stability and readiness for production use. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 6 Jan 2026): Attendance and Projects V1 endpoints are deprecated with a final removal date of August 30, 2026; integrations must migrate to V2 versions to maintain service. ### December 2025 - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 27 Dec 2025): V1 endpoints for Attendances and Projects have been deprecated with an extended removal deadline; integrations should migrate to V2 versions. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 21 Dec 2025): V1 Attendances and Projects endpoints deprecated with extended deprecation deadline; integrations should migrate to V2 endpoints. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 16 Dec 2025): Cost Center, Org Unit, and Workplace APIs have graduated from beta status and are now generally available for production use. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 15 Dec 2025): Beta flags removed from Cost Center, Org Unit, and Workplace APIs, which are now generally available and production-ready. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 15 Dec 2025): V1 endpoints for Attendances and Projects have been deprecated with extended deprecation deadline; integrations must migrate to V2 endpoints before removal. - **Reporting API V2 Endpoints** (New feature, 10 Dec 2025): New Reporting API V2 with support for new data points including target earnings, total payout, goal bonus, bonus payout, and project/location tracking attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 10 Dec 2025): New status query parameter added to GET /v2/persons endpoint to enable filtering persons by their latest employment status. - **Hiring Team Array in Recruiting API** (New feature, 6 Dec 2025): A new hiring_team array has been added to Recruiting API responses for applications and jobs, listing all persons responsible for the job or application. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 4 Dec 2025): Attendance and Projects v1 endpoints will be deprecated with final removal date of August 30, 2026; integrations must migrate to v2 APIs. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 1 Dec 2025): Attendances and Projects V1 endpoints deprecated in favor of V2 versions with final deprecation date of 2026-08-30, requiring migration to V2 APIs. ### November 2025 - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 24 Nov 2025): Breaking change scheduled for 06.07.2026: the created_at field will change from a different timezone to UTC format in document list responses. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 16 Nov 2025): V1 endpoints for Attendances and Projects have been deprecated with extended deprecation deadline; integrations must migrate to V2 endpoints. - **Job reference now available on Employment** (New feature, 8 Nov 2025): New job reference field added to Employment endpoint, providing additional employment relationship data without breaking existing integrations. - **Improved attendance project tracking capabilities exposed through V2 Projects and Project Members endpoints** (New feature, 6 Nov 2025): New advanced project attributes, subprojects concept (via parent_project.id), and new project members endpoints have been added for improved project and employee assignment tracking. - **Improved attendance project tracking capabilities are exposed through the V2 Projects and Project Members endpoints** (New feature, 4 Nov 2025): V2 Projects endpoints now support advanced project attributes, subprojects via parent_project.id, and new endpoints for managing employee project assignments. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 1 Nov 2025): V2 Projects and Project Members endpoints now expose advanced project attributes, subprojects support via parent_project.id, and new assignment management endpoints. - **Update of the TLS Certificate** (Other, 1 Nov 2025): TLS certificate upgrade from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but some clients may need to update certificate validation. ### October 2025 - **Job reference now available on Employment** (New feature, 24 Oct 2025): Job reference field is now available on Employment endpoint, enabling additional data retrieval. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 6 Oct 2025): V2 Projects endpoints now support advanced project attributes, subprojects via parent_project.id, and new endpoints for managing employee project assignments. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 1 Oct 2025): Attendance and Projects v1 endpoints are deprecated with final removal date of August 30, 2026; integrations must migrate to v2 APIs to maintain service. ### September 2025 - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 1 Sept 2025): Three additional APIs (Cost Center, Org Unit, Workplace) removed from beta and are now generally available for production use. - **Job reference now available on Employment** (New feature, 1 Sept 2025): New job reference field added to Employment endpoints, providing additional context linking employment records to job data. - **Jobs and Salary Bands Available** (New feature, 1 Sept 2025): New endpoints or data fields for Jobs and Salary Bands have been added to the API. - **Reporting API V2 Endpoints** (New feature, 1 Sept 2025): New reporting API introduced providing access to reports and attributes data from the new report builder, including new compensation and attendance attributes not available in V1. ### August 2025 - **Status filter in list persons endpoint** (New feature, 15 Aug 2025): New status query parameter added to GET /v2/persons endpoint for filtering by person's latest employment status. - **Fixed Missing Termination Fields in Employments** (Bug fix, 6 Aug 2025): Bug fix for GET /v2/persons/{person_id}/employments endpoint where termination object fields were omitted from responses; credential refresh required to access corrected data. - **Fixed Missing Termination Fields in Employments** (Bug fix, 4 Aug 2025): Bug fix for GET /v2/persons/{person_id}/employments endpoint where three termination object fields were not being returned; credential refresh required. - **Job reference now available on Employment** (New feature, 1 Aug 2025): Job reference field added to Employment endpoint responses, providing additional context about associated job positions. - **Jobs and Salary Bands Available** (New feature, 1 Aug 2025): New Jobs and Salary Bands endpoints have been added to the API for accessing job and compensation band data. ### July 2025 - **Reporting API V2 Endpoints** (New feature, 17 Jul 2025): New Reporting API V2 endpoints introduced for accessing reports and attributes from analytics 2.0 platform, including new compensation and attendance attributes. ### June 2025 - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 24 Jun 2025): The created_at field in document list response is changing its value format to UTC, effective 06.07.2026; this is a breaking change to response format. ### May 2025 - **Job reference now available on Employment** (New feature, 20 May 2025): Job reference field has been added to the Employment endpoint response. - **Status filter in list persons endpoint** (New feature, 1 May 2025): New status query parameter added to GET /v2/persons endpoint enabling filtering of persons by employment status. ### April 2025 - **Reporting API V2 Endpoints** (New feature, 1 Apr 2025): New Reporting API V2 introduced with access to reports and attributes from analytics 2.0 platform, including new compensation and attendance data points not available in V1. ### February 2025 - **Deprecated** (Deprecation, 24 Feb 2025): query-string credentials on POST /v1/auth: Deprecation: Query-string credentials authentication method for POST /v1/auth is deprecated with removal scheduled for 2026-12-04; migrate to alternative authentication methods. ### January 2025 - **Job reference now available on Employment** (New feature, 17 Jan 2025): Job reference field is now exposed on Employment endpoint responses for additional context. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 16 Jan 2025): V1 endpoints for Attendances and Projects have been deprecated, requiring migration to V2 endpoints to maintain integration functionality. - **Recruiting API is Generally Available** (New feature, 16 Jan 2025): Recruiting API beta flag removed and endpoints now generally available, indicating the API is production-ready. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 15 Jan 2025): The created_at field response format is being changed to return UTC timezone, which may break integrations expecting different timezone handling. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 10 Jan 2025): Cost Center, Org Unit, and Workplace APIs have been promoted from beta/preview status to General Availability (GA), indicating stability and production-readiness. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 10 Jan 2025): The created_at field in document list response will change to return UTC timestamps, with effective date July 6, 2026. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 9 Jan 2025): Beta flag removed from Cost Center, Org Unit, and Workplace endpoints, moving them to GA status with no breaking changes expected. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 9 Jan 2025): V1 endpoints for Attendances and Projects are deprecated with an extended deprecation deadline; integrations using these endpoints will need to migrate to V2 versions. - **Job reference now available on Employment** (New feature, 9 Jan 2025): The Employment endpoint now includes a job reference field, enhancing the relationship between employment records and job data. - **Jobs and Salary Bands Available** (New feature, 9 Jan 2025): New Jobs and Salary Bands endpoints have been added to the API, providing additional HR data capabilities for integrations. - **Status filter in list persons endpoint** (New feature, 9 Jan 2025): New status query parameter added to GET /v2/persons endpoint to filter persons by employment status. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 8 Jan 2025): V1 endpoints for Attendances and Projects are being deprecated with an extended deprecation deadline; integrations using these endpoints will need to migrate to V2 versions. - **Job reference now available on Employment** (New feature, 8 Jan 2025): The Employment endpoint now includes a job reference field, providing better linkage between employment records and job definitions. - **Jobs and Salary Bands Available** (New feature, 8 Jan 2025): New Jobs and Salary Bands endpoints are now available in the API, expanding capabilities for job and compensation data management. - **Status filter in list persons endpoint** (New feature, 8 Jan 2025): Added a new status query parameter to the GET /v2/persons endpoint to allow filtering persons by their latest employment status. - **Job reference now available on Employment** (New feature, 7 Jan 2025): The Employment endpoint now includes a job reference field, providing improved linking between employment records and job data. - **Jobs and Salary Bands Available** (New feature, 7 Jan 2025): New Jobs and Salary Bands endpoints/fields have been added to the API, expanding data access capabilities. - **Status filter in list persons endpoint** (New feature, 7 Jan 2025): New status query parameter added to GET /v2/persons endpoint enabling filtering by employment status, expanding filtering capabilities. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 6 Jan 2025): V1 endpoints for Attendances and Projects are being deprecated with extended deprecation deadline, requiring users to migrate to V2 endpoints. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 3 Jan 2025): Beta flag removed from Cost Center, Org Unit, and Workplace APIs, indicating they are now stable and generally available for production use. - **Status filter in list persons endpoint** (New feature, 3 Jan 2025): Added a new status query parameter to the GET /v2/persons endpoint for filtering by employment status, a new capability that doesn't break existing integrations. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 2 Jan 2025): Three previously beta APIs (Cost Center, Org Unit, and Workplace) have been promoted to general availability with the beta flag removed, indicating stability and production readiness. - **Job reference now available on Employment** (New feature, 2 Jan 2025): New feature: The Employment resource now includes a job reference field, providing additional context linking employees to their jobs. - **Jobs and Salary Bands Available** (New feature, 2 Jan 2025): New feature: Jobs and Salary Bands endpoints are now available in the API for expanded HR data access. - **Status filter in list persons endpoint** (New feature, 2 Jan 2025): Added a new status query parameter to GET /v2/persons endpoint for filtering persons by employment status. ### December 2024 - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 27 Dec 2024): The created_at field in document list responses will change format to UTC, with effective date July 6, 2026, requiring integration updates to handle the new timestamp format. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 26 Dec 2024): The created_at field in document list responses will change to UTC format, effective 06.07.2026, which could affect integrations parsing this timestamp. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 25 Dec 2024): Beta flag removed from Cost Center, Org Unit, and Workplace APIs, indicating they are now production-ready and stable for integration. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 20 Dec 2024): The created_at field timestamp format has been changed to UTC, which is a breaking change for integrations relying on the previous timestamp format. - **Reporting API V2 Endpoints** (New feature, 20 Dec 2024): Introduced new reporting API for accessing reports and analytics data with new compensation and attendance attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 20 Dec 2024): Added new status query parameter to GET /v2/persons endpoint to filter persons by employment status. - **Update of the TLS Certificate** (Other, 20 Dec 2024): TLS certificate on API endpoints will be updated from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but some clients may need certificate validation updates. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 19 Dec 2024): Cost Center, Org Unit and Workplace APIs have moved from beta to general availability, indicating these endpoints are now stable and recommended for production use. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 19 Dec 2024): The created_at field in document management endpoints will now consistently return UTC timezone instead of potentially variable timezone formats, affecting timestamp handling in integrations. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 19 Dec 2024): V1 endpoints for Attendances and Projects are being deprecated with an extended deadline; integrations using these endpoints will need to migrate to V2 alternatives. - **Job reference now available on Employment** (New feature, 19 Dec 2024): New feature: Job reference data is now included in Employment endpoint responses, enriching employment records with job information. - **Jobs and Salary Bands Available** (New feature, 19 Dec 2024): New feature: Jobs and Salary Bands endpoints are now available in the API, expanding HR data management capabilities. - **Status filter in list persons endpoint** (New feature, 19 Dec 2024): Added new status query parameter to GET /v2/persons endpoint for filtering by person's employment status. - **Update of the TLS Certificate** (Other, 19 Dec 2024): TLS certificate upgrade from RSA 2048-bit to ECDSA P-256 scheduled for Q3 2026; most integrations require no action but certificate pinning implementations may need updates. - **Recruiting API is Generally Available** (New feature, 18 Dec 2024): Recruiting API has graduated from beta to GA status with all endpoints now generally available for production use. - **Reporting API V2 Endpoints** (New feature, 16 Dec 2024): Introduced new Reporting API V2 with access to new reports, attributes, and data points not available in V1 including compensation and project/location tracking data. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 15 Dec 2024): The created_at field in document management API responses will now return UTC timestamps instead of the previous format, requiring integrations to handle UTC timezone conversion. - **Reporting API V2 Endpoints** (New feature, 15 Dec 2024): New reporting API introduced with access to reports and analytics data including new compensation and attendance attributes not available in V1. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 13 Dec 2024): Beta flag removed from Cost Center, Org Unit, and Workplace APIs, promoting them to general availability status. - **Reporting API V2 Endpoints** (New feature, 13 Dec 2024): New reporting API introduced providing access to reports and analytics data with new compensation and attendance attributes not available in V1. - **Reporting API V2 Endpoints** (New feature, 11 Dec 2024): New reporting API introduced providing access to analytics 2.0 reports and attributes including compensation and attendance data not available in V1, expanding analytics capabilities. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 10 Dec 2024): The created_at field in document management API responses will be converted to UTC format, a scheduled breaking change. - **Job reference now available on Employment** (New feature, 10 Dec 2024): Employment API now includes job reference data, allowing integrations to link employment records to job information. - **Jobs and Salary Bands Available** (New feature, 10 Dec 2024): New Jobs and Salary Bands APIs are now available as part of the platform. - **Reporting API V2 Endpoints** (New feature, 9 Dec 2024): Introduced a new reporting API providing access to reports and attributes data from the analytics 2.0 platform with new data points like compensation attributes (target earnings, total payout, goal bonus, bonus payout) and attendance attributes not available in V1. - **Jobs and Salary Bands Available** (New feature, 8 Dec 2024): New Jobs and Salary Bands API endpoints are now available, expanding integration capabilities for recruitment and compensation data. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 6 Dec 2024): The created_at field in document list responses will change to return UTC timezone on July 6, 2026; integrations relying on the current timezone format may experience breaking changes. - **Reporting API V2 Endpoints** (New feature, 6 Dec 2024): Introduced new Reporting API V2 endpoints providing access to new report builder data and compensation/attendance attributes not available in V1, enabling enhanced reporting capabilities. - **created_at field in GET /v2/document-management/documents will return UTC** (Bug fix, 5 Dec 2024): The created_at field in the document management API now returns UTC timestamps, fixing a consistency issue with timestamp formatting. - **Reporting API V2 Endpoints** (New feature, 5 Dec 2024): New reporting API introduced with access to analytics 2.0 reports and additional data points not available in V1 (compensation, attendance, project and location tracking attributes). - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 4 Dec 2024): The created_at field timestamp format will be standardized to UTC with an effective date of 06.07.2026, requiring integration updates for timestamp handling. - **Deprecated** (Deprecation, 4 Dec 2024): query-string credentials on POST /v1/auth: Query-string credentials authentication method on the POST /v1/auth endpoint is deprecated with removal scheduled for December 4, 2026. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 3 Dec 2024): The created_at field in the document management API will now return timestamps in UTC format, which is a behavioral fix that could affect timestamp handling in integrations. - **Reporting API V2 Endpoints** (New feature, 3 Dec 2024): Introduced new reporting API with access to reports and attributes from analytics 2.0 platform, including new compensation and attendance data points not available in V1. - **Reporting API V2 Endpoints** (New feature, 2 Dec 2024): Introduced new Reporting API V2 with access to Analytics 2.0 platform reports and new data points (compensation attributes like target earnings, goal bonus; attendance attributes for project/location tracking) not available in V1. ### November 2024 - **Update of the TLS Certificate** (Other, 29 Nov 2024): Personio is updating TLS certificates from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but certificate pinning strategies may need review. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 28 Nov 2024): Attendances and Projects V1 endpoints are deprecated and will be removed in the future, requiring migration to newer versions. - **Recruiting API is Generally Available** (New feature, 28 Nov 2024): Recruiting API beta flag removed and endpoints now in GA status, indicating API stability and readiness for production use. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 27 Nov 2024): The created_at field in document list response will change to UTC format, effective 06.07.2026, requiring integration updates before the deadline. - **Job reference now available on Employment** (New feature, 27 Nov 2024): The Employment endpoint now includes a job reference field, providing enhanced employment data. - **Jobs and Salary Bands Available** (New feature, 27 Nov 2024): New Jobs and Salary Bands API endpoints have been added to the platform, expanding available capabilities. - **Status filter in list persons endpoint** (New feature, 27 Nov 2024): Added new status query parameter to GET /v2/persons endpoint to filter persons by their latest employment status. - **Update of the TLS Certificate** (Other, 27 Nov 2024): TLS certificate being updated from RSA 2048-bit to ECDSA P-256 in Q3 2026; most integrations require no action but should verify certificate compatibility. - **created_at field in GET /v2/document-management/documents will return UTC** (Bug fix, 25 Nov 2024): The created_at field in the document management API endpoint now returns timestamps in UTC format, standardizing timestamp handling. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 24 Nov 2024): Breaking change scheduled for July 6, 2026 where the created_at field in document list responses will change from local timezone to UTC format. - **Deprecated** (Deprecation, 22 Nov 2024): query-string credentials on POST /v1/auth: Query-string credentials authentication method on the POST /v1/auth endpoint is deprecated and will be removed on 2026-12-04; integrations should migrate to alternative authentication methods. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 21 Nov 2024): Cost Center, Org Unit, and Workplace APIs have reached general availability status with stabilized endpoints. - **Deprecated** (Deprecation, 21 Nov 2024): query-string credentials on POST /v1/auth: Query-string based authentication method on POST /v1/auth endpoint is deprecated and will be removed on 2026-12-04. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 21 Nov 2024): V1 endpoints for Attendances and Projects APIs have been deprecated and require migration to V2 versions. - **Reporting API V2 Endpoints** (New feature, 21 Nov 2024): Introduced new Reporting API V2 with access to new report builder data and new compensation/attendance attributes not available in V1. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 20 Nov 2024): V1 endpoints for Attendances and Projects are deprecated with extended deadline announced; integrations must plan migration to V2 equivalents. - **Job reference now available on Employment** (New feature, 20 Nov 2024): Job reference field is now available in Employment endpoints, improving data enrichment for employment records. - **Jobs and Salary Bands Available** (New feature, 20 Nov 2024): New Jobs and Salary Bands endpoints added to the API, expanding reporting and organizational structure capabilities. - **Recruiting API is Generally Available** (New feature, 20 Nov 2024): Recruiting API beta flag removed and endpoints are now generally available, indicating API stability and readiness for production use. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 19 Nov 2024): Cost Center, Org Unit and Workplace APIs have graduated to General Availability status, indicating they are now stable for production use. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 19 Nov 2024): The created_at field timestamp format changed to UTC, which may affect integrations relying on specific timezone handling. - **Deprecated** (Deprecation, 19 Nov 2024): query-string credentials on POST /v1/auth: Query-string credentials authentication method for POST /v1/auth is deprecated with removal scheduled for December 4, 2026. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 19 Nov 2024): V1 endpoints for Attendances and Projects have been deprecated and will be removed in the future, requiring migration to V2 endpoints. - **Job reference now available on Employment** (New feature, 19 Nov 2024): The Employment endpoint now includes a job reference field, providing additional context linking employment records to job positions. - **Jobs and Salary Bands Available** (New feature, 19 Nov 2024): New Jobs and Salary Bands endpoints are now available in the API, adding new data access capabilities. - **Reporting API V2 Endpoints** (New feature, 19 Nov 2024): New reporting API launched providing access to reports and analytics 2.0 data with new compensation and attendance attributes not available in V1. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 16 Nov 2024): Attendance and Projects V1 endpoints deprecated with final removal date of August 30, 2026; integrations must migrate to V2 endpoints. - **Recruiting API is Generally Available** (New feature, 15 Nov 2024): Recruiting API has graduated from beta to GA status, indicating stability and long-term support commitment for recruitment-related integrations. - **Status filter in list persons endpoint** (New feature, 15 Nov 2024): Added new status query parameter to GET /v2/persons endpoint for filtering by employment status, a non-breaking new capability. - **Update of the TLS Certificate** (Other, 15 Nov 2024): TLS certificate has been updated, which may require clients to update their certificate chains or trust stores to maintain secure connections. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 14 Nov 2024): Cost Center, Org Unit, and Workplace APIs have graduated from beta to general availability status. - **Jobs and Salary Bands Available** (New feature, 14 Nov 2024): New Jobs and Salary Bands endpoints have been added to the API, providing access to job and compensation band data. - **Reporting API V2 Endpoints** (New feature, 14 Nov 2024): Introduced new reporting API with access to analytics 2.0 platform reports including new compensation and attendance attributes not available in V1. - **Job reference now available on Employment** (New feature, 9 Nov 2024): New job reference field added to Employment endpoint responses. - **Jobs and Salary Bands Available** (New feature, 9 Nov 2024): New Jobs and Salary Bands API endpoints have been added to the platform. - **Deprecated** (Deprecation, 8 Nov 2024): query-string credentials on POST /v1/auth: Query-string based credentials on the authentication endpoint are deprecated with removal date December 4, 2026, requiring migration to body-based authentication. - **Job reference now available on Employment** (New feature, 8 Nov 2024): New field added to Employment endpoint exposing job reference data, enabling better linkage between employment records and job definitions. - **Deprecated** (Deprecation, 7 Nov 2024): query-string credentials on POST /v1/auth: Query-string credential authentication on POST /v1/auth is deprecated with removal scheduled for 2026-12-04, requiring migration to alternative authentication methods. - **Job reference now available on Employment** (New feature, 7 Nov 2024): Employment endpoint responses now include a job reference field, enabling better linkage between employment records and job definitions. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 6 Nov 2024): The created_at field in the document list response will change to return UTC time with an effective date of 06.07.2026; this is a breaking change in field value format. - **Deprecated** (Deprecation, 4 Nov 2024): query-string credentials on POST /v1/auth: Query-string authentication method on POST /v1/auth endpoint is deprecated with removal scheduled for December 4, 2026; integrations must switch to header-based authentication. - **Deprecated** (Deprecation, 1 Nov 2024): query-string credentials on POST /v1/auth: Query-string based credentials on POST /v1/auth endpoint are deprecated with removal scheduled for 2026-12-04; integrations must migrate to alternative authentication methods. - **Reporting API V2 Endpoints** (New feature, 1 Nov 2024): New reporting API endpoints introduced providing access to analytics 2.0 platform reports with new compensation and attendance attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 1 Nov 2024): New status query parameter added to GET /v2/persons endpoint for filtering by employment status, enabling new filtering capabilities. ### October 2024 - **Reporting API V2 Endpoints** (New feature, 27 Oct 2024): Introduced new reporting API V2 endpoints providing access to reports and analytics 2.0 platform data with new compensation and attendance attributes not available in V1. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 24 Oct 2024): The created_at field response format will change to UTC with effective date of 06.07.2026. - **Reporting API V2 Endpoints** (New feature, 24 Oct 2024): New reporting API introduced with access to reports and analytics 2.0 platform data including compensation and attendance attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 24 Oct 2024): A status filter has been added to the list persons endpoint, allowing integrations to more efficiently query persons by their status. - **Recruiting API is Generally Available** (New feature, 22 Oct 2024): Recruiting API has graduated from beta/preview status to General Availability, indicating stability for production use. - **Update of the TLS Certificate** (Other, 22 Oct 2024): TLS certificate has been updated, which may affect API connectivity if clients have strict certificate pinning or validation rules. - **Job reference now available on Employment** (New feature, 21 Oct 2024): The Employment endpoint now includes a job reference field for linking employment records to job data. - **Jobs and Salary Bands Available** (New feature, 21 Oct 2024): New Jobs and Salary Bands API endpoints are now available for accessing job and salary band data. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 20 Oct 2024): Beta flag removed from Cost Center, Org Unit, and Workplace APIs, promoting them to generally available status. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 20 Oct 2024): V1 endpoints for Attendances and Projects are deprecated with extended deprecation deadline; integrations should migrate to V2 endpoints before removal date. - **Reporting API V2 Endpoints** (New feature, 20 Oct 2024): New reporting API introduced with access to reports and attributes from analytics 2.0 platform, including new compensation and attendance data points not available in V1. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 19 Oct 2024): Three APIs (Cost Center, Org Unit, and Workplace) have graduated from beta to GA status and are now available for production use. - **Deprecated** (Deprecation, 19 Oct 2024): query-string credentials on POST /v1/auth: Query string credentials for authentication on the POST /v1/auth endpoint are now deprecated, requiring integrations to migrate to body-based credentials or other authentication methods. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 19 Oct 2024): Attendance and projects V1 endpoints deprecated with final deprecation date of August 30, 2026; integrations must migrate to V2 APIs. - **Job reference now available on Employment** (New feature, 19 Oct 2024): Job reference field has been added to Employment endpoint responses, providing additional context about employee job assignments. - **Reporting API V2 Endpoints** (New feature, 19 Oct 2024): Introduced new reporting API V2 with access to analytics 2.0 platform reports and new data points including compensation and attendance attributes not available in V1. - **created_at field in GET /v2/document-management/documents will return UTC** (Bug fix, 17 Oct 2024): Document Management API's created_at field now returns UTC timestamp instead of potentially using a different timezone. - **Deprecated** (Deprecation, 17 Oct 2024): query-string credentials on POST /v1/auth: Query-string based authentication on the v1 auth endpoint is now deprecated, requiring migration to header-based authentication. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 17 Oct 2024): Attendance and projects V1 endpoints deprecated with final removal date of August 30, 2026; integrations must migrate to V2 APIs. - **Hiring Team Array in Recruiting API** (New feature, 17 Oct 2024): Added new hiring_team array to Recruiting API responses for applications and jobs showing assigned responsible persons. - **Reporting API V2 Endpoints** (New feature, 17 Oct 2024): Introduced new Reporting API V2 with access to new report builder data including new compensation and attendance attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 17 Oct 2024): New status filter parameter added to the list persons endpoint, enabling filtering of persons by status. - **Deprecated** (Deprecation, 16 Oct 2024): query-string credentials on POST /v1/auth: Query-string based credentials authentication method on the V1 auth endpoint has been deprecated, requiring migration to body-based or header-based authentication. - **Hiring Team Array in Recruiting API** (New feature, 16 Oct 2024): Added new hiring_team array to Recruiting API responses for applications and jobs listing all assigned persons. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 15 Oct 2024): Three APIs have graduated from beta to GA status, providing stable endpoints for organizational structure and workplace management. - **Deprecated** (Deprecation, 15 Oct 2024): query-string credentials on POST /v1/auth: Query-string credentials authentication method for the POST /v1/auth endpoint is now deprecated, requiring migration to a more secure authentication approach. - **Job reference now available on Employment** (New feature, 15 Oct 2024): Employment endpoint enhanced with job reference field for better job tracking. - **Reporting API V2 Endpoints** (New feature, 15 Oct 2024): Introduced new reporting API v2 with access to analytics 2.0 data including new compensation and project/location tracking attributes not available in v1. - **created_at field in GET /v2/document-management/documents will return UTC** (Bug fix, 10 Oct 2024): The created_at field in document management endpoint now returns UTC timezone, fixing a timezone inconsistency issue. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 9 Oct 2024): Attendance and projects v1 endpoints are deprecated with final removal date of Aug 30, 2026; integrations must migrate to v2 APIs. - **Job reference now available on Employment** (New feature, 9 Oct 2024): Job reference field has been added to Employment endpoint responses, providing additional context about job assignments. - **Jobs and Salary Bands Available** (New feature, 9 Oct 2024): New Jobs and Salary Bands APIs have been made available for integration. - **Reporting API V2 Endpoints** (New feature, 9 Oct 2024): New reporting API introduced with access to reports and attributes data from analytics 2.0 platform, including new compensation and attendance attributes not available in V1. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 6 Oct 2024): Breaking change scheduled for July 6, 2026 where the created_at field will be converted to UTC format; integrations parsing this timestamp will need to be updated. - **Deprecated** (Deprecation, 4 Oct 2024): query-string credentials on POST /v1/auth: Deprecation: Query-string credentials authentication method on POST /v1/auth is deprecated with removal scheduled for 2026-12-04, requiring migration to alternative auth methods. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 2 Oct 2024): The created_at field in document list response will change its timezone handling to UTC, effective 06.07.2026; this is a breaking change requiring timestamp handling updates. - **Deprecated** (Deprecation, 1 Oct 2024): query-string credentials on POST /v1/auth: Query-string credentials on POST /v1/auth endpoint are deprecated with removal date set for 2026-12-04, requiring migration to alternative authentication methods. - **Reporting API V2 Endpoints** (New feature, 1 Oct 2024): New reporting API v2 endpoints introduced with access to analytics 2.0 reports and new compensation/attendance attributes not available in v1. - **Status filter in list persons endpoint** (New feature, 1 Oct 2024): Added new status query parameter to GET /v2/persons endpoint to enable filtering by employment status. ### September 2024 - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 27 Sept 2024): Beta flags removed from Cost Center, Org Unit, and Workplace APIs; these endpoints are now generally available for production use. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 27 Sept 2024): V1 Attendances and Projects endpoints deprecated with extended deprecation deadline; integrations must migrate to V2 endpoints before removal date. - **Reporting API V2 Endpoints** (New feature, 26 Sept 2024): New V2 endpoints released for the Reporting API, providing improved reporting capabilities. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 20 Sept 2024): Breaking change: created_at field format will change in document list response to return UTC; effective 2026-07-06 and requires integration updates to handle new timestamp format. - **Hiring Team Array in Recruiting API** (New feature, 20 Sept 2024): Introduced new hiring_team array to Recruiting API responses for applications and jobs showing assigned persons responsible for each. - **Job reference now available on Employment** (New feature, 20 Sept 2024): New job reference field added to Employment endpoint response for better employment-to-job relationship tracking. - **Jobs and Salary Bands Available** (New feature, 20 Sept 2024): New Jobs and Salary Bands endpoints or data now available in the API. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 19 Sept 2024): The created_at field in document-management endpoint will change to return UTC timestamps, effective 2026-07-06, representing a breaking change to response format. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 19 Sept 2024): Attendances and Projects V1 endpoints deprecated with final removal date of August 30, 2026; all integrations must migrate to V2 APIs. - **Hiring Team Array in Recruiting API** (New feature, 19 Sept 2024): New hiring_team array added to Recruiting API responses for applications and jobs, listing persons assigned as responsible; array is empty if no persons assigned. - **Job reference now available on Employment** (New feature, 19 Sept 2024): Employment endpoint enriched with job reference field, providing additional context linking employment records to job definitions. - **Jobs and Salary Bands Available** (New feature, 19 Sept 2024): New Jobs and Salary Bands endpoints added to API, expanding available data models for integration. - **Reporting API V2 Endpoints** (New feature, 19 Sept 2024): New Reporting API V2 introduced with access to analytics 2.0 reports and new compensation/attendance attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 19 Sept 2024): A new status filter parameter has been added to the list persons endpoint, allowing more granular filtering of employee records by status. - **Deprecated** (Deprecation, 17 Sept 2024): query-string credentials on POST /v1/auth: Query-string based credential passing on the auth endpoint is deprecated, requiring migration to body-based or header-based authentication methods. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 17 Sept 2024): Attendance and projects V1 endpoints deprecated with Aug 30, 2026 deadline; integrations must migrate to V2 APIs. - **Improved attendance project tracking capabilities exposed through V2 Projects endpoints** (New feature, 16 Sept 2024): V2 Projects and Project Members endpoints now support advanced project attributes, subprojects via parent_project.id, and new endpoints for managing employee project assignments. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 15 Sept 2024): Attendance and projects v1 endpoints deprecated with final removal date of Aug 30, 2026; requires migration to v2 APIs. - **Hiring Team Array in Recruiting API** (New feature, 15 Sept 2024): New hiring_team array added to Recruiting API responses for applications and jobs, listing all persons assigned as responsible. - **Status filter in list persons endpoint** (New feature, 15 Sept 2024): A new status filter parameter has been added to the list persons endpoint, improving filtering capabilities for person records. - **Hiring Team Array in Recruiting API** (New feature, 13 Sept 2024): Added a new hiring_team array to Recruiting API responses for applications and jobs listing assigned persons, expanding the API's data richness without breaking changes. - **Improved attendance project tracking capabilities with V2 Projects endpoints** (New feature, 13 Sept 2024): Exposed advanced project attributes, introduced subprojects concept via parent_project.id, and added new endpoints for managing employee project assignments. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 12 Sept 2024): Expanded V2 Projects and Project Members endpoints with advanced project attributes, subprojects support via parent_project.id, and new member management endpoints. - **Status filter in list persons endpoint** (New feature, 10 Sept 2024): GET /v2/persons endpoint now includes a status query parameter to filter persons by their latest employment status. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 9 Sept 2024): Enhanced V2 Projects and Project Members endpoints with advanced project attributes, subprojects support via parent_project.id, and new employee assignment management endpoints. - **Deprecated** (Deprecation, 4 Sept 2024): query-string credentials on POST /v1/auth: Query-string based credentials for the POST /v1/auth endpoint are deprecated with removal scheduled for December 4, 2026; integrations should migrate to request body credentials. - **Status filter in list persons endpoint** (New feature, 4 Sept 2024): New feature: Added status query parameter to GET /v2/persons endpoint to filter persons by their latest employment status. - **Hiring Team Array in Recruiting API** (New feature, 3 Sept 2024): Added new hiring_team array to Recruiting API responses for applications and jobs, listing all persons assigned as responsible. - **Deprecated** (Deprecation, 2 Sept 2024): query-string credentials on POST /v1/auth: Query-string based credentials authentication on POST /v1/auth is deprecated and will be removed on December 4, 2026; integrations must migrate to alternative authentication methods. - **Hiring Team Array in Recruiting API** (New feature, 2 Sept 2024): Added new hiring_team array to Recruiting API responses for applications and jobs, listing all persons assigned as responsible for each resource. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 1 Sept 2024): V1 attendances and projects endpoints deprecated with final removal date of Aug 30, 2026; integrations must migrate to v2 APIs. - **Hiring Team Array in Recruiting API** (New feature, 1 Sept 2024): Introduced new hiring_team array to Recruiting API responses for applications and jobs, listing assigned persons responsible for positions. - **Reporting API V2 Endpoints** (New feature, 1 Sept 2024): New reporting API introduced providing access to reports and attributes from analytics 2.0 platform with new data points including compensation attributes (target earnings, total payout, goal bonus, bonus payout) and attendance attributes for project and location tracking not available in V1. ### August 2024 - **Hiring Team Array in Recruiting API** (New feature, 29 Aug 2024): Hiring team information is now exposed as an array in the Recruiting API endpoints. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 27 Aug 2024): Added advanced project attributes, subproject support via parent_project.id, and new project members management endpoints for employee assignment tracking. - **Hiring Team Array in Recruiting API** (New feature, 24 Aug 2024): New hiring_team array added to Recruiting API responses for applications and jobs listing responsible persons. - **Hiring Team Array in Recruiting API** (New feature, 23 Aug 2024): New hiring_team array added to Recruiting API responses for applications and jobs, listing all persons responsible for a job or application. - **Deprecated** (Deprecation, 20 Aug 2024): query-string credentials on POST /v1/auth: Query-string based credential authentication on POST /v1/auth is deprecated with removal scheduled for 2026-12-04; integrations should switch to body-based authentication. - **Hiring Team Array in Recruiting API** (New feature, 19 Aug 2024): Added new hiring_team array to Recruiting API responses for applications and jobs, listing all persons assigned as responsible with empty array when none assigned. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 19 Aug 2024): Introduced advanced project attributes, subprojects support via parent_project.id, and new project members endpoints for managing employee assignment to projects. - **Reporting API V2 Endpoints** (New feature, 19 Aug 2024): New V2 endpoints for the Reporting API have been released, providing updated reporting capabilities. - **Status filter in list persons endpoint** (New feature, 19 Aug 2024): New status query parameter added to GET /v2/persons endpoint enabling filtering by employment status, improving query efficiency. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 15 Aug 2024): Advanced project attributes, subprojects support via parent_project.id, and new project members endpoints added for enhanced employee assignment tracking. - **Reporting API V2 Endpoints** (New feature, 15 Aug 2024): New V2 endpoints have been added to the Reporting API, providing updated reporting capabilities alongside the existing V1 endpoints. - **Status filter in list persons endpoint** (New feature, 15 Aug 2024): New status filter parameter added to list persons endpoint for better filtering capabilities. - **Deprecated** (Deprecation, 9 Aug 2024): query-string credentials on POST /v1/auth: Query-string credentials authentication method on POST /v1/auth endpoint deprecated with removal scheduled for 2026-12-04; use body or header-based authentication instead. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 9 Aug 2024): Attendance and projects v1 endpoints will be deprecated with final removal date of Aug 30, 2026, requiring migration to v2 APIs. - **Reporting API V2 Endpoints** (New feature, 9 Aug 2024): New Reporting API V2 introduced with access to new data points including compensation and attendance attributes not available in V1. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 3 Aug 2024): Introduced advanced project attributes, subprojects concept via parent_project.id, and new endpoints for managing employee assignment to projects. - **Improved attendance project tracking capabilities V2** (New feature, 2 Aug 2024): Exposed advanced Project attributes in V2 Projects and Project Members endpoints, introduced Subprojects concept via parent_project.id, and added new endpoints for managing employee assignment to projects. - **Status filter in list persons endpoint** (New feature, 2 Aug 2024): New status query parameter added to GET /v2/persons endpoint to enable filtering persons by employment status. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 1 Aug 2024): Attendance and projects v1 endpoints deprecated with final removal date of Aug 30, 2026; integrations must migrate to v2 APIs. - **Hiring Team Array in Recruiting API** (New feature, 1 Aug 2024): New hiring_team array added to Recruiting API responses for applications and jobs endpoints, listing all persons assigned as responsible for a job or application. - **Improved attendance project tracking capabilities exposed through V2 Projects endpoints** (New feature, 1 Aug 2024): Advanced project attributes, subprojects concept, and new project member management endpoints introduced for enhanced attendance tracking. ### July 2024 - **Fixed Missing Termination Fields in Employments** (Bug fix, 27 Jul 2024): Fixed issue where termination fields were not being returned in GET /v2/persons/{person_id}/employments endpoint responses; credential refresh required. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 27 Jul 2024): V2 Projects and Project Members endpoints now expose advanced project attributes, subprojects concept, and new employee assignment management endpoints. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 24 Jul 2024): Advanced project attributes, subprojects concept, and new project members endpoints introduced for enhanced project management. - **Improved attendance project tracking capabilities through V2 Projects endpoints** (New feature, 23 Jul 2024): V2 Projects and Project Members endpoints now expose advanced project attributes, support subprojects via parent_project.id, and new member assignment endpoints. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 20 Jul 2024): Advanced project attributes, subprojects support via parent_project.id, and new project members endpoints added for improved project and employee tracking. - **Status filter in list persons endpoint** (New feature, 20 Jul 2024): New status query parameter added to GET /v2/persons endpoint enabling filtering by person's employment status. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 19 Jul 2024): Attendance and projects v1 endpoints deprecated with removal date August 30, 2026; integrations must migrate to v2 APIs. - **Fixed Missing Termination Fields in Employments** (Bug fix, 19 Jul 2024): Bug fix for GET /v2/persons/{person_id}/employments endpoint where three fields in the termination object were not being returned; requires credential refresh. - **Improved attendance project tracking capabilities exposed through V2 Projects endpoints** (New feature, 19 Jul 2024): New advanced project attributes, subproject support via parent_project.id, and new project members endpoints added for managing employee project assignments. - **Reporting API V2 Endpoints** (New feature, 19 Jul 2024): New Reporting API V2 introduced with access to analytics 2.0 platform reports and new compensation/attendance data points unavailable in V1. - **Status filter in list persons endpoint** (New feature, 19 Jul 2024): New status query parameter added to GET /v2/persons endpoint to enable filtering by person's latest employment status. - **Reporting API V2 Endpoints** (New feature, 18 Jul 2024): New Reporting API V2 endpoints provide access to analytics 2.0 platform reports with expanded data points including compensation and attendance attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 18 Jul 2024): New status query parameter added to GET /v2/persons endpoint enabling filtering by a person's employment status. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 17 Jul 2024): Enhanced V2 Projects and Project Members endpoints with advanced project attributes, subprojects support via parent_project.id, and new employee assignment endpoints. - **Status filter in list persons endpoint** (New feature, 17 Jul 2024): New status filter parameter added to the list persons endpoint, allowing more granular filtering of employee records. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 15 Jul 2024): V1 attendance and projects endpoints deprecated with final removal date of August 30, 2026; integrations must migrate to V2 endpoints. - **Reporting API V2 Endpoints** (New feature, 15 Jul 2024): New Reporting API V2 endpoints released as improved alternative to V1. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 14 Jul 2024): V2 Projects endpoints now expose advanced project attributes, subprojects via parent_project.id, and new endpoints for managing employee project assignments. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 9 Jul 2024): Attendances and Projects V1 endpoints deprecated in favor of V2 versions with final removal date of 2026-08-30; integrations must migrate to V2 APIs. - **Hiring Team Array in Recruiting API** (New feature, 9 Jul 2024): New hiring_team array added to Recruiting API responses for applications and jobs, listing all persons assigned as responsible. - **Reporting API V2 Endpoints** (New feature, 9 Jul 2024): New Reporting API V2 endpoints introduced providing access to reports and analytics 2.0 data with new compensation and attendance attributes not available in V1. - **Reporting API V2 Endpoints** (New feature, 2 Jul 2024): New Reporting API V2 introduced with access to new report builder data and expanded attributes like target earnings, total payout, goal bonus, and project/location tracking. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 1 Jul 2024): V1 attendance and projects endpoints deprecated with final removal date of August 30, 2026; integrations must migrate to V2 versions. - **Fixed Missing Termination Fields in Employments** (Bug fix, 1 Jul 2024): Fixed issue where three fields within the termination object were not being returned from GET /v2/persons/{person_id}/employments endpoint; credential refresh required. - **Hiring Team Array in Recruiting API** (New feature, 1 Jul 2024): Added new hiring_team array to Recruiting API responses for applications and jobs showing all assigned responsible persons. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 1 Jul 2024): V2 Projects endpoints now support advanced project attributes, subprojects via parent_project.id, and new project members management endpoints. - **Reporting API V2 Endpoints** (New feature, 1 Jul 2024): New Reporting API V2 introduced with access to new reports and data points including compensation attributes (target earnings, total payout, goal bonus) and attendance attributes not available in V1. ### June 2024 - **Job reference now available on Employment** (New feature, 27 Jun 2024): New job reference field added to Employment endpoint responses for better job tracking. - **Jobs and Salary Bands Available** (New feature, 27 Jun 2024): New Jobs and Salary Bands endpoints added to API capabilities. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 24 Jun 2024): Breaking change: created_at field will return UTC timestamp format effective 06.07.2026; integrations handling timestamp normalization must be updated. - **Reporting API V2 Endpoints** (New feature, 24 Jun 2024): New V2 endpoints for the Reporting API released, providing updated reporting capabilities alongside existing V1 endpoints. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 20 Jun 2024): V1 endpoints for Attendances and Projects have been marked as deprecated, with integrations expected to migrate to V2 endpoints in the future. - **Fixed Missing Termination Fields in Employments** (Bug fix, 20 Jun 2024): Missing termination-related fields have been added to employment data in GET /v2/persons, requiring credential refresh for access. - **Office to Workplace renaming update** (Other, 20 Jun 2024): Offices experience renamed to Workplaces to reflect modern work arrangements including remote and non-office locations. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 19 Jun 2024): Attendance and Projects v1 endpoints deprecated in favor of v2 versions with final deprecation date of August 30, 2026. - **Hiring Team Array in Recruiting API** (New feature, 19 Jun 2024): New hiring_team array added to Recruiting API responses for applications and jobs showing all assigned responsible persons. - **Reporting API V2 Endpoints** (New feature, 19 Jun 2024): New Reporting API V2 introduced providing access to new report builder analytics with additional data points including compensation and attendance attributes not available in V1. - **Fixed Missing Termination Fields in Employments** (Bug fix, 16 Jun 2024): Fixed issue where termination object fields were not being returned in GET /v2/persons/{person_id}/employments endpoint; credential refresh required. - **Fixed Missing Termination Fields in Employments** (Bug fix, 15 Jun 2024): Bug fix for GET /v2/persons/{person_id}/employments endpoint where termination object fields were not being returned; credential refresh required. - **Fixed Missing Termination Fields in Employments** (Bug fix, 13 Jun 2024): Bug fix for GET /v2/persons/{person_id}/employments endpoint where three termination object fields were missing from responses; credential refresh required. - **Hiring Team Array in Recruiting API** (New feature, 13 Jun 2024): A new hiring_team array field has been added to Recruiting API responses for applications and jobs, listing all persons assigned as responsible. - **Fixed Missing Termination Fields in Employments** (Bug fix, 9 Jun 2024): Fixed GET /v2/persons/{person_id}/employments endpoint to properly return three missing fields in the termination object (credential refresh required). - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 9 Jun 2024): New advanced project attributes, subprojects concept, and project members management endpoints added to V2 Projects API. - **Fixed Missing Termination Fields in Employments** (Bug fix, 7 Jun 2024): Fixed a bug where three fields within the termination object were not being returned from GET /v2/persons/{person_id}/employments endpoint; credential refresh required to see fix. - **Fixed Missing Termination Fields in Employments** (Bug fix, 3 Jun 2024): Resolved an issue where three fields within the termination object were not being returned in GET /v2/persons/{person_id}/employments endpoint; credential refresh required. - **Fixed Missing Termination Fields in Employments** (Bug fix, 2 Jun 2024): Resolved issue where three termination object fields were missing from GET /v2/persons/{person_id}/employments endpoint responses; credential refresh required to access fix. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 1 Jun 2024): Attendance and Projects V1 endpoints deprecated with final removal date of 2026-08-30; integrations must migrate to V2 APIs. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 1 Jun 2024): Exposed advanced project attributes in V2 Projects and Project Members endpoints, introduced subprojects concept via parent_project.id, and added new endpoints for managing employee project assignments. - **Reporting API V2 Endpoints** (New feature, 1 Jun 2024): New reporting API introduced with access to analytics 2.0 platform reports and new data points including compensation and attendance attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 1 Jun 2024): New status query parameter added to GET /v2/persons endpoint for filtering by employment status, expanding endpoint capabilities. ### May 2024 - **Deprecated** (Deprecation, 27 May 2024): query-string credentials on POST /v1/auth: Query-string credentials authentication method deprecated with removal date 2026-12-04; integrations must migrate to body-based credential submission. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 27 May 2024): V1 endpoints for Attendances and Projects marked as deprecated, signaling planned migration to V2 endpoints. - **Reporting API V2 Endpoints** (New feature, 27 May 2024): New Reporting API V2 introduced providing access to reports and analytics data with new compensation and attendance attributes not available in V1. - **Status filter in list persons endpoint** (New feature, 27 May 2024): New status query parameter added to GET /v2/persons endpoint enabling filtering by person's latest employment status. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 23 May 2024): V2 Projects and Project Members endpoints now expose advanced project attributes, subprojects concept with parent_project.id, and new endpoints for managing employee project assignments. - **Reporting API V2 Endpoints** (New feature, 20 May 2024): New Reporting API V2 introduced providing access to analytics 2.0 reports and new data points including compensation attributes (target earnings, total payout, goal bonus) and attendance attributes not available in V1. - **Fixed Missing Termination Fields in Employments** (Bug fix, 19 May 2024): Bug fix for GET /v2/persons/{person_id}/employments endpoint where three fields within the termination object were not being returned; credential refresh required. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 19 May 2024): V2 Projects and Project Members endpoints now expose advanced project attributes, subprojects support, and new endpoints for managing employee assignments. - **Job reference now available on Employment** (New feature, 18 May 2024): The Employment endpoint now includes a job reference field, providing additional employment data. - **Fixed Missing Termination Fields in Employments** (Bug fix, 17 May 2024): Fixed issue where termination object fields were missing from GET /v2/persons/{person_id}/employments endpoint; credential refresh required. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 16 May 2024): Improved pagination links in Attendance Periods API V2 to use absolute URLs instead of relative URLs. - **Hiring Team Array in Recruiting API** (New feature, 16 May 2024): The Recruiting API now exposes hiring team information as an array, enhancing recruitment workflow integration capabilities. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 15 May 2024): Pagination links in Attendance Periods API V2 now return absolute URLs instead of relative URLs. - **Fixed Missing Termination Fields in Employments** (Bug fix, 15 May 2024): Fixed bug where three termination fields in GET /v2/persons/{person_id}/employments were not being returned; credential refresh required. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 15 May 2024): New advanced project attributes, subprojects concept (via parent_project.id), and project members endpoints added for enhanced attendance project tracking. - **Job reference now available on Employment** (New feature, 15 May 2024): The Employment endpoint now includes a job reference field, providing additional context linking employees to their job records. - **Jobs and Salary Bands Available** (New feature, 15 May 2024): New Jobs and Salary Bands endpoints have been added to the V2 API, expanding available HR data capabilities. - **Fixed Missing Termination Fields in Employments** (Bug fix, 14 May 2024): Fixed GET /v2/persons/{person_id}/employments endpoint to properly return termination object fields; credential refresh required. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 13 May 2024): Pagination links for Attendance Periods API V2 now return absolute URLs instead of relative URLs. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 10 May 2024): Improved pagination links in Attendance Periods API V2 to use absolute URLs instead of relative URLs for better clarity. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 9 May 2024): Updated Attendance Periods API V2 pagination links to use absolute URLs. - **Hiring Team Array in Recruiting API** (New feature, 9 May 2024): A new hiring_team array has been added to Recruiting API responses for applications and jobs, listing all persons assigned as responsible. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 2 May 2024): Improved pagination links in Attendance Periods API V2 to use absolute URLs for better integration compatibility. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 2 May 2024): Attendance and Projects V1 endpoints deprecated with final removal date of August 30, 2026; all integrations must migrate to V2 APIs. - **Fixed Missing Termination Fields in Employments** (Bug fix, 1 May 2024): Bug fix for GET /v2/persons/{person_id}/employments endpoint that was omitting termination object fields; credential refresh required. ### April 2024 - **Hiring Team Array in Recruiting API** (New feature, 29 Apr 2024): Hiring team information now exposed as an array in the Recruiting API, providing enhanced recruitment workflow data. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 19 Apr 2024): Updated pagination links in Attendance Periods API V2 to use absolute URLs instead of relative URLs. - **Improved attendance project tracking capabilities are exposed through V2 Projects and Project Members endpoints** (New feature, 19 Apr 2024): V2 Projects and Project Members endpoints now expose advanced Project attributes including subproject support and employee assignment capabilities. - **Improved attendance project tracking capabilities through V2 Projects and Project Members endpoints** (New feature, 18 Apr 2024): V2 endpoints for Projects and Project Members have been added to expose enhanced attendance project tracking functionality. - **New validations to project tracking** (Other, 16 Apr 2024): Introduced new validations to project tracking APIs for attendances to improve data integrity and prevent accidental data issues. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 15 Apr 2024): Improved pagination links in Attendance Periods API V2 to use absolute URLs. - **Hiring Team Array in Recruiting API** (New feature, 15 Apr 2024): Recruiting API enhanced with hiring team array field for better team tracking. - **Improved attendance project tracking capabilities are exposed through the V2 Projects and Project Members endpoints** (New feature, 15 Apr 2024): V2 Projects and Project Members endpoints released with enhanced attendance project tracking capabilities. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 14 Apr 2024): Updated Attendance Periods API V2 pagination links to use absolute URLs for improved consistency. - **New validations to project tracking** (Other, 13 Apr 2024): New validations introduced to project tracking APIs to improve data integrity and prevent accidental data issues. - **New validations to project tracking** (Other, 12 Apr 2024): Introduced new validations to project tracking APIs to improve data integrity and prevent accidental data issues during attendance project management. - **Improved attendance project tracking capabilities exposed through V2 Projects endpoints** (New feature, 9 Apr 2024): V2 Projects and Project Members endpoints now support advanced project attributes, subprojects via parent_project.id, and new employee assignment management capabilities. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 2 Apr 2024): V2 Projects and Project Members endpoints now expose advanced project attributes, subprojects via parent_project.id, and new endpoints for managing employee project assignments. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 1 Apr 2024): Pagination links in Attendance Periods API V2 updated to use absolute URLs instead of relative URLs. - **Deprecated** (Deprecation, 1 Apr 2024): query-string credentials on POST /v1/auth: Query-string credentials on the POST /v1/auth endpoint are deprecated with removal scheduled for December 4, 2026, requiring migration to alternative authentication methods. - **Fixed Missing Termination Fields in Employments** (Bug fix, 1 Apr 2024): Fixed issue where three termination fields were missing from GET /v2/persons/{person_id}/employments response; credential refresh required to access fix. - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 1 Apr 2024): V2 Projects and Project Members endpoints now expose advanced Project attributes, support Subprojects via parent_project.id, and include new endpoints for managing employee project assignments. ### March 2024 - **Improved attendance project tracking capabilities through V2 Projects and Project Members endpoints** (New feature, 21 Mar 2024): V2 endpoints for Projects and Project Members released with enhanced attendance project tracking capabilities. - **Cost Centers and Workplaces Available** (New feature, 19 Mar 2024): Two new endpoints added for accessing cost centers and workplaces data, expanding organizational structure API capabilities. - **Deprecated** (Deprecation, 19 Mar 2024): query-string credentials on POST /v1/auth: Query-string based credentials authentication method is deprecated on POST /v1/auth with removal date set for December 4, 2026. - **Fixed Missing Termination Fields in Employments** (Bug fix, 19 Mar 2024): Bug fix resolving missing termination fields in GET /v2/persons/{person_id}/employments endpoint responses; credential refresh required. - **New validations to project tracking** (Other, 19 Mar 2024): New validations introduced to project tracking APIs to improve data integrity and prevent accidental data issues in attendance project management. - **Improved attendance project tracking capabilities through V2 Projects endpoints** (New feature, 18 Mar 2024): V2 Projects and Project Members endpoints now expose advanced project attributes including subprojects and employee assignment capabilities for improved attendance tracking. - **New validations to project tracking** (Other, 2 Mar 2024): Introduced new validations to project management APIs for attendances to improve data integrity and prevent accidental data issues. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 1 Mar 2024): Updated Attendance Periods API V2 pagination links to use absolute URLs instead of relative URLs for improved compatibility. - **Fixed Missing Termination Fields in Employments** (Bug fix, 1 Mar 2024): Fixed issue where three termination fields were missing from GET /v2/persons/{person_id}/employments endpoint; credential refresh required to see fix. - **New validations to project tracking** (Other, 1 Mar 2024): New validations introduced to project tracking APIs for attendance management to improve data integrity. ### February 2024 - **Cost Centers and Workplaces Available** (New feature, 23 Feb 2024): Added two new endpoints for accessing cost centers and workplaces data, expanding the API's scope for organizational structure management. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 19 Feb 2024): Pagination links in Attendance Periods API v2 now return absolute URLs instead of relative URLs. - **Cost Centers and Workplaces Available** (New feature, 19 Feb 2024): Added two new endpoints for accessing cost centers and workplaces data. - **Fixed Missing Termination Fields in Employments** (Bug fix, 19 Feb 2024): Missing termination fields have been fixed in the Employment endpoint, though credential refresh is required to see the changes. - **Office to Workplace renaming update** (Other, 19 Feb 2024): Offices renamed to Workplaces throughout the API to better reflect modern work environments including remote and non-office locations. - **Fixed Missing Termination Fields in Employments** (Bug fix, 15 Feb 2024): Bug fix for GET /v2/persons/{person_id}/employments endpoint where termination object fields were not being returned; credential refresh required to receive the fix. - **Office to Workplace renaming update** (Other, 15 Feb 2024): Renamed Offices to Workplaces throughout the API to reflect modern work location flexibility. - **Cost Centers and Workplaces Available** (New feature, 13 Feb 2024): Two new endpoints added for accessing cost centers and workplaces data. - **Cost Centers and Workplaces endpoints** (New feature, 9 Feb 2024): Added two new endpoints for accessing Cost Centers and Workplaces data. - **Fixed Missing Termination Fields in Employments** (Bug fix, 8 Feb 2024): Missing termination-related fields have been restored in the GET /v2/persons employment endpoint; credential refresh is required for the fix to take effect. - **Cost Centers and Workplaces Available** (New feature, 1 Feb 2024): Added two new endpoints for accessing Cost Centers and Workplaces data, expanding organizational structure API capabilities. - **Office to Workplace renaming update** (Other, 1 Feb 2024): Renamed Office concept to Workplace to better reflect that employees may work in non-office locations or remotely, with plans for expanded functionality. ### January 2024 - **Office -> Workplace renaming update** (Other, 20 Jan 2024): Renamed Offices to Workplaces to reflect modern work arrangements and support future functionality expansion. - **Cost Centers and Workplaces Available** (New feature, 19 Jan 2024): Added two new endpoints for accessing Cost Centers and Workplaces data, expanding organizational structure data availability. - **Office to Workplace renaming update** (Other, 19 Jan 2024): Renamed Offices to Workplaces to reflect modern work arrangements; this is a nomenclature update supporting future functionality expansion. - **Status filter in list persons endpoint** (New feature, 19 Jan 2024): A new status query parameter has been added to GET /v2/persons endpoint to enable filtering persons by their latest employment status. - **Status filter in list persons endpoint** (New feature, 18 Jan 2024): A new status query parameter has been added to GET /v2/persons endpoint for filtering by employment status. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 17 Jan 2024): V1 endpoints for Attendances and Projects have been deprecated with an extended deprecation deadline and additional details provided. - **Office to Workplace renaming update** (Other, 16 Jan 2024): Renamed Offices feature to Workplaces to reflect that employees may work in non-office or remote locations. - **Office to Workplace renaming update** (Other, 15 Jan 2024): Offices feature renamed to Workplaces to reflect modern work arrangements including remote and non-office locations. - **Office to Workplace renaming update** (Other, 13 Jan 2024): Offices renamed to Workplaces to better reflect that employees may work in non-office or remote locations. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 12 Jan 2024): Beta flag removed from Cost Center, Org Unit, and Workplace APIs, advancing them to generally available status. - **Absolute URLs in Pagination Links for Attendance Periods API V2** (Other, 11 Jan 2024): Pagination links in the Attendance Periods API V2 now return absolute URLs instead of relative URLs. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 9 Jan 2024): V1 Attendances and Projects endpoints deprecation deadline has been extended with additional details provided. - **Office to Workplace renaming update** (Other, 9 Jan 2024): Renamed Offices to Workplaces to reflect support for non-office and remote work locations. - **Recruiting API is Generally Available** (New feature, 9 Jan 2024): Recruiting API has graduated from beta to general availability, indicating the API is now stable and recommended for production use. - **created_at field in GET /v2/document-management/documents will return UTC** (Breaking, 6 Jan 2024): The created_at field in document list response will change to return UTC format with effective date of 06.07.2026. - **Cost Center, Org Unit and Workplace APIs are Generally Available** (New feature, 3 Jan 2024): Beta flag removed from Cost Center, Org Unit and Workplace API endpoints, promoting them to general availability status. - **Office to Workplace renaming update** (Other, 3 Jan 2024): Renamed Offices to Workplaces terminology across the API to reflect non-office work locations and support future functionality expansion. - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 2 Jan 2024): V1 endpoints for Attendances and Projects have been deprecated, signaling a planned migration path for users still on the legacy API versions. - **Fixed Missing Termination Fields in Employments** (Bug fix, 2 Jan 2024): Fixed issue where three termination fields were missing from GET /v2/persons/{person_id}/employments responses; credential refresh required to apply fix. - **Office to Workplace renaming update** (Other, 2 Jan 2024): Renamed Offices to Workplaces across the API to reflect modern work environment terminology and support future functionality expansion. - **Cost Centers and Workplaces Available** (New feature, 1 Jan 2024): Two new endpoints added to access Cost Centers and Workplaces data. - **New validations to project tracking** (Other, 1 Jan 2024): New validations introduced to project tracking APIs to improve data integrity and user experience. ### December 2023 - **Office to Workplace renaming update** (Other, 24 Dec 2023): Offices renamed to Workplaces to reflect diverse work locations including remote work. - **Office to Workplace renaming update** (Other, 19 Dec 2023): Offices entity renamed to Workplaces to better reflect that employees may work in non-office locations or remotely. - **Reporting API V2 Endpoints** (New feature, 18 Dec 2023): New Reporting API V2 endpoints provide access to reports and analytics data with new compensation and attendance attributes not available in V1. - **Office to Workplace renaming update** (Other, 17 Dec 2023): Renamed Offices to Workplaces to reflect modern work environments including non-office and remote locations. - **Fixed Missing Termination Fields in Employments** (Bug fix, 15 Dec 2023): Bug fix resolving missing termination fields in GET /v2/persons/{person_id}/employments endpoint response; credential refresh required. - **Office to Workplace renaming update** (Other, 14 Dec 2023): Renamed Offices to Workplaces to reflect that employees may work in non-office locations or remotely, with plans for expanded functionality. - **created_at field in GET /v2/document-management/documents returns UTC** (Breaking, 12 Dec 2023): The created_at field in document management API responses now returns UTC timestamp format, which may require parsing updates in integrations. - **Office to Workplace renaming update** (Other, 1 Dec 2023): Offices renamed to Workplaces in the API to better reflect that employees may work in non-office or remote locations. ### November 2023 - **Deprecation of Attendances and Projects V1 Endpoints** (Deprecation, 18 Nov 2023): V1 Attendances and Projects endpoints are deprecated with final removal on August 30, 2026, requiring migration to V2 endpoints. - **Job reference now available on Employment** (New feature, 17 Nov 2023): Job reference field is now available on Employment endpoints for better job tracking. - **Jobs and Salary Bands Available** (New feature, 17 Nov 2023): New Jobs and Salary Bands APIs have been made available for use. - **Office to Workplace renaming update** (Other, 1 Nov 2023): Renamed Office concept to Workplace throughout the API to reflect modern work arrangements including non-office and remote locations. ### October 2023 - **Hiring Team Array in Recruiting API** (New feature, 18 Oct 2023): A new hiring_team array has been added to Recruiting API responses for applications and jobs, listing responsible persons. - **Deprecated** (Deprecation, 17 Oct 2023): query-string credentials on POST /v1/auth: Query-string credentials authentication method for POST /v1/auth is deprecated with removal scheduled for 2026-12-04. ### September 2023 - **Improved attendance project tracking capabilities through V2 Projects endpoints** (New feature, 18 Sept 2023): V2 Projects and Project Members endpoints now expose advanced project attributes, subprojects support, and employee assignment management. - **Office to Workplace renaming update** (Other, 1 Sept 2023): Renamed Offices to Workplaces to reflect that employees may work in non-office or remote locations. ### August 2023 - **Reporting API V2 Endpoints** (New feature, 17 Aug 2023): New Reporting API V2 introduced with access to reports and attributes from analytics 2.0 platform, including new compensation and attendance attributes. ### July 2023 - **Fixed Missing Termination Fields in Employments** (Bug fix, 18 Jul 2023): The GET /v2/persons/{person_id}/employments endpoint now returns previously missing termination object fields. ### June 2023 - **Hiring Team Array in Recruiting API** (New feature, 17 Jun 2023): New hiring_team array added to Recruiting API responses for applications and jobs to list assigned responsible persons. ### May 2023 - **Improved attendance project tracking capabilities in V2 Projects endpoints** (New feature, 17 May 2023): New advanced Project attributes and Subprojects concept introduced through updated V2 Projects and Project Members endpoints with new member management endpoints. ## Other APIs we monitor - [Airtable](https://seamless.engineering/api-changelog/airtable/) - [Brevo](https://seamless.engineering/api-changelog/brevo/) - [DATEV](https://seamless.engineering/api-changelog/datev/) - [Discord](https://seamless.engineering/api-changelog/discord/) - [Google Sheets](https://seamless.engineering/api-changelog/google-sheets/) - [HubSpot](https://seamless.engineering/api-changelog/hubspot/) - [Jira Cloud](https://seamless.engineering/api-changelog/jira/) - [lexoffice](https://seamless.engineering/api-changelog/lexoffice/) - [Linear](https://seamless.engineering/api-changelog/linear/) - [Monday.com](https://seamless.engineering/api-changelog/monday/) - [Notion](https://seamless.engineering/api-changelog/notion/) - [Pinterest API](https://seamless.engineering/api-changelog/pinterest/) - [Pipedrive](https://seamless.engineering/api-changelog/pipedrive/) - [Salesforce](https://seamless.engineering/api-changelog/salesforce/) - [Shopify](https://seamless.engineering/api-changelog/shopify/) - [Slack](https://seamless.engineering/api-changelog/slack/) - [Stripe](https://seamless.engineering/api-changelog/stripe/) - [Xentral](https://seamless.engineering/api-changelog/xentral/) - [Zendesk](https://seamless.engineering/api-changelog/zendesk/) ## Frequently asked questions ### Has the Personio API had breaking changes recently? Yes: 0 breaking changes and 3 deprecations in the last 90 days. The most recent is “Deprecated” from 4 December 2026. ### How often does the Personio API change? Over the period on record, Personio published about 11 changelog entries a month. Most are additions; the breaking changes and deprecations are the ones to plan for. ### Where is the official Personio API changelog? Personio publishes it at https://developer.personio.de/changelog. This page follows it daily and dates each entry. ### How do I get notified about Personio API changes? Subscribe to this page's RSS feed (https://seamless.engineering/api-changelog/personio/rss.xml). If you would rather have someone act on them, we operate Personio integrations and handle changes like these before they reach production. ## Request a scoping call We watch Personio because we run integrations on it. If one of yours depends on Personio, we can take it over: build it properly, operate it, and fix it when Personio changes, before your data is affected. Fixed-price scoping quote within 48 hours. - Email: hello@seamless.engineering - Contact form: https://seamless.engineering/#contact