Personnel Data
API for reading and writing personnel data incl. data about attendances and absences
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
API for reading and writing personnel data incl. data about attendances and absences
Endpoints 13
- GETGET /company/attendances
/company/attendances?start_date=2024-01-01&end_date=2024-01-01&updated_from=string&updated_to=string&employees=0&limit=200&offset=0This endpoint is responsible for fetching attendance data for the company employees. It is possible to paginate results, filter by period, the date and/or… - POSTPOST /company/attendances
/company/attendancesThis endpoint is responsible for adding attendance data for the company employees. It is possible to add attendances for one or many employees at the same… - DELETEDELETE /company/attendances/{id}
/company/attendances/:idThis endpoint is responsible for deleting attendance data for the company employees. - PATCHPATCH /company/attendances/{id}
/company/attendances/:idThis endpoint is responsible for updating attendance data for the company employees. Attributes are not required and if not specified, the current value will… - GETGET /company/employees
/company/employeesList Employees - POSTCreate an employee
/company/employeesCreates new employee. Status of the employee will be set to active if hire_date provided is in past. Otherwise status will be set to onboarding. This endpoint… - GETGET /company/employees/{employee_id}
/company/employees/:employee_idShow employee by ID - GETGET /company/employees/{employee_id}/profile-picture/{width}
/company/employees/:employee_id/profile-picture/:widthShow employee profile picture - GETGET /company/time-off-types
/company/time-off-types?limit=200&offset=0Provides a list of available time-off types, for example 'Paid vacation', 'Parental leave' or 'Home office' - GETGET /company/time-offs
/company/time-offs?start_date=2024-01-01&end_date=2024-01-01&updated_from=string&updated_to=string&employees=0&limit=200&offset=0This endpoint is responsible for fetching absence data for the company employees. It is possible to paginate results, filter by period and/or specific… - POSTPOST /company/time-offs
/company/time-offsThis endpoint is responsible for adding absence data for the company employees. - GETGET /company/time-offs/{id}
/company/time-offs/:idAbsence Period - DELETEDELETE /company/time-offs/{id}
/company/time-offs/:idThis endpoint is responsible for deleting absence period data for the company employees.
API details
- Base URL
https://api.personio.de/v1- Authentication
- An API key in the Authorization header
- Operations
- 13 operations on 8 pathsGET 7POST 3DELETE 2PATCH 1
- Response formats
application/jsonimage/png- Description format
- OpenAPI 3.0.0, API version
1.0 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Personnel Data in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Personnel Data collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “GET /company/attendances” (GET /company/attendances?start_date=2024-01-01&end_date=2024-01-01&updated_from=string&updated_to=string&employees=0&limit=200&offset=0), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Personnel Data?
API for reading and writing personnel data incl. data about attendances and absences It is listed under Other and has 13 endpoints.
Who publishes the Personnel Data?
It is listed from Personio's public API description (an OpenAPI document), not published by Personio on Swastik Codes. Anyone who controls personio.de can claim the profile by adding a DNS TXT record.
What is the base URL of the Personnel Data?
Requests go to https://api.personio.de/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Personnel Data?
With an API key in the Authorization header.
How many endpoints does the Personnel Data have?
13 operations on 8 paths (7 GET, 3 POST, 2 DELETE, 1 PATCH).
Is forking the Personnel Data free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.