--- title: "Get employee details from Personio API" url: "https://getknit.dev/blog/get-employee-details-from-personio-api-rhovmw/" date: "2024-08-02T07:20:10+00:00" modified: "2024-09-13T14:08:26+00:00" type: "post" --- # Get employee details from Personio API [Blog](https://getknit.dev/blog) / [Tutorials](https://getknit.dev/blogs/tutorials/) / Get employee details from Personio API [Tutorials](https://getknit.dev/blogs/tutorials/) · August 2, 2024 · Updated September 13, 2024 Get employee details from Personio API ====================================== ![](https://storage.googleapis.com/knit-website-media/2026/08/64c34c8eb1ffc79e7f787ecd_Akshat-3-112x112.png)Akshat Jain 2 min read [](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fgetknit.dev%2Fblog%2Fget-employee-details-from-personio-api-rhovmw%2F) [](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgetknit.dev%2Fblog%2Fget-employee-details-from-personio-api-rhovmw%2F&text=Get%20employee%20details%20from%20Personio%20API) Table of Contents - [Introduction](#introduction) - [Get Employee Details from Personio API](#get-employee-details-from-personio-api) - [Overview](#overview) - [Step-by-Step Guide](#step-by-step-guide) - [Knit for Personio API Integration](#knit-for-personio-api-integration) Introduction ------------ This article is a part of a series of articles covering the Personio API in depth, and covers the specific use case of using the Personio API to Get employee details from Peronio API. You can find all the other use cases we have covered for the Personio API along with a comprehensive deep dive on its various aspects like authentication, rate limits etc [here.](/blog/personio-api-directory-lw5f1o/) Get Employee Details from Personio API -------------------------------------- ### Overview To retrieve employee details such as first name, last name, and date of joining from the Personio API, you can utilize the `listEmployees` endpoint. Below is a step-by-step guide with Python code snippets to achieve this. ### Step-by-Step Guide #### 1. Set Up Your Environment Ensure you have the necessary libraries installed: ``` pip install requests ``` #### 2. Define API Credentials Set your API credentials for authentication: ``` api_url = "https://api.personio.de/v1/company/employees" headers = { "X-Personio-Partner-ID": "your_partner_id", "X-Personio-App-ID": "your_app_id", "accept": "application/json" } ``` #### 3. Make the API Request Send a GET request to the `listEmployees` endpoint to fetch the required details: ``` import requests params = { "attributes[]": ["first_name", "last_name", "hire_date"] } response = requests.get(api_url, headers=headers, params=params) if response.status_code == 200: employees = response.json().get("data", []) for employee in employees: first_name = employee["attributes"].get("first_name") last_name = employee["attributes"].get("last_name") hire_date = employee["attributes"].get("hire_date") print(f"First Name: {first_name}, Last Name: {last_name}, Date of Joining: {hire_date}") else: print(f"Failed to retrieve data: {response.status_code}") ``` #### 4. Handle the Response Process the response to extract and display the employee details: ``` if response.status_code == 200: employees = response.json().get("data", []) for employee in employees: first_name = employee["attributes"].get("first_name") last_name = employee["attributes"].get("last_name") hire_date = employee["attributes"].get("hire_date") print(f"First Name: {first_name}, Last Name: {last_name}, Date of Joining: {hire_date}") else: print(f"Failed to retrieve data: {response.status_code}") ``` Knit for Personio API Integration --------------------------------- For quick and seamless access to [Personio](/integration/personio/) API, Knit API offers a convenient solution. By integrating with Knit just once, you can streamline the entire process. Knit takes care of all the authentication, authorization, and ongoing integration maintenance, this approach not only saves time but also ensures a smooth and reliable connection to your [Personio](/integration/personio/) API. Building a Personio integration? Knit gives you three ways to build it. Pick the one that fits. - [Personio on Unified API](https://getknit.dev/integration/personio/) Your customers want Personio and the other HRIS tools they use. Build one integration and get normalised read and write data with real-time webhooks. [Try free](https://dashboard.getknit.dev/signup) - [Personio on Integrations Agent](https://getknit.dev/ipaas-connectors/personio/) You need one specific Personio workflow. Describe it in plain English and get production-ready code, not fixed iPaaS blocks. [Try free](https://agent.getknit.dev/) - [Personio MCP server](https://getknit.dev/mcp-servers/personio-mcp-server/) Your AI agent needs to read and act in your customers' Personio. Use a pre-built, hosted MCP server instead of writing integration code. [Try free](https://mcphub.getknit.dev/) Knit's Unified API connects to 190+ apps across HRIS, ATS, CRM, accounting and more. Knit never stores your end users' data and is SOC 2, GDPR and ISO 27001 compliant: [How Knit handles security](/security/) · [Security Center](https://compliance.getknit.dev/) Not sure which fits? [Talk to a human](/book-demo/) ![](https://storage.googleapis.com/knit-website-media/2026/08/64c34c8eb1ffc79e7f787ecd_Akshat-3-112x112.png)Written by Akshat Jain Coding chaos into innovation and building from zero to scale Keep Reading ------------ ![Personio API Directory](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-green-640x400.png) [API Directory](https://getknit.dev/blogs/api-directory/) ### [Personio API Directory](https://getknit.dev/blog/personio-api-directory-lw5f1o/) Learn about the common Personio API data models and API end points in this comprehensive Personio API directory November 11, 2024 · 16 min read ![How to Get an Okta API Token (Step-by-Step)](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-red-scaled-640x400.png) [Tutorials](https://getknit.dev/blogs/tutorials/) ### [How to Get an Okta API Token (Step-by-Step)](https://getknit.dev/blog/okta-api-key/) Generate an Okta API token in the Admin Console, add it as an SSWS Authorization header, and call the Okta… July 22, 2026 · 8 min read ![Get Ticket Data from Freshdesk API using Python](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-red-scaled-640x400.png) [Tutorials](https://getknit.dev/blogs/tutorials/) ### [Get Ticket Data from Freshdesk API using Python](https://getknit.dev/blog/get-ticket-data-from-freshdesk-api-using-python/) Learn how to retrieve ticket data from the Freshdesk API with step-by-step instructions, endpoints, code examples, common pitfalls, and FAQs… April 11, 2026 · 5 min read \#1 in Ease of Integrations --------------------------- ![4.9 out of 5 stars](/wp-content/themes/knit/assets/images/g2/g2-star-rating.svg) 4.9 out of 5 stars on G2 ![G2 Leader, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-leader.svg)![G2 Fastest Implementation, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-fastest-implementation.svg)![G2 High Performer, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-high-performer.svg)![G2 Best Est. ROI, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-best-roi.svg) Put Integrations on Autopilot. Talk to Experts. ----------------------------------------------- Knit is loved by customers across the globe due to our seamless product and white glove support. You'll love us too! [Talk to a Human](/book-demo)