Personnel Data

personio · Company

Company No Auth Free & Open enterprise

API for reading and writing personnel data incl. data about attendances and absences

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET GET /company/attendances

This endpoint is responsible for fetching attendance data for the company employees. It is possible to paginate results, filter by period, the date and/or time it was updated, and/or specific employees. The result will contain a list of attendance periods, structured as defined here.

https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/attendances?limit=200&offset=0&end_date=2024-12-31&employees=example&start_date=2024-01-01&updated_to=example&updated_from=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/attendances?limit=200&offset=0&end_date=2024-12-31&employees=example&start_date=2024-01-01&updated_to=example&updated_from=example"

import requests
params = {
    "limit": "200",
    "offset": "0",
    "end_date": "2024-12-31",
    "employees": "example",
    "start_date": "2024-01-01",
    "updated_to": "example",
    "updated_from": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/attendances",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/attendances');
url.searchParams.set('limit', '200');
url.searchParams.set('offset', '0');
url.searchParams.set('end_date', '2024-12-31');
url.searchParams.set('employees', 'example');
url.searchParams.set('start_date', '2024-01-01');
url.searchParams.set('updated_to', 'example');
url.searchParams.set('updated_from', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/attendances")
	q := baseURL.Query()
	q.Set("limit", "200")
	q.Set("offset", "0")
	q.Set("end_date", "2024-12-31")
	q.Set("employees", "example")
	q.Set("start_date", "2024-01-01")
	q.Set("updated_to", "example")
	q.Set("updated_from", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/attendances")
uri.query = URI.encode_www_form({
  "limit" => "200",
  "offset" => "0",
  "end_date" => "2024-12-31",
  "employees" => "example",
  "start_date" => "2024-01-01",
  "updated_to" => "example",
  "updated_from" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/attendances?" . http_build_query([
    "limit" => "200",
    "offset" => "0",
    "end_date" => "2024-12-31",
    "employees" => "example",
    "start_date" => "2024-01-01",
    "updated_to" => "example",
    "updated_from" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET GET /company/time-off-types

Provides a list of available time-off types, for example 'Paid vacation', 'Parental leave' or 'Home office'

https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-off-types?limit=200&offset=0

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-off-types?limit=200&offset=0"

import requests
params = {
    "limit": "200",
    "offset": "0"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-off-types",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-off-types');
url.searchParams.set('limit', '200');
url.searchParams.set('offset', '0');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-off-types")
	q := baseURL.Query()
	q.Set("limit", "200")
	q.Set("offset", "0")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-off-types")
uri.query = URI.encode_www_form({
  "limit" => "200",
  "offset" => "0"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-off-types?" . http_build_query([
    "limit" => "200",
    "offset" => "0"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET GET /company/time-offs

This endpoint is responsible for fetching absence data for the company employees. It is possible to paginate results, filter by period and/or specific employees. The result will contain a list of absence periods, structured as defined here.

https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-offs?limit=200&offset=0&end_date=2024-12-31&employees=example&start_date=2024-01-01&updated_to=example&updated_from=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-offs?limit=200&offset=0&end_date=2024-12-31&employees=example&start_date=2024-01-01&updated_to=example&updated_from=example"

import requests
params = {
    "limit": "200",
    "offset": "0",
    "end_date": "2024-12-31",
    "employees": "example",
    "start_date": "2024-01-01",
    "updated_to": "example",
    "updated_from": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-offs",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-offs');
url.searchParams.set('limit', '200');
url.searchParams.set('offset', '0');
url.searchParams.set('end_date', '2024-12-31');
url.searchParams.set('employees', 'example');
url.searchParams.set('start_date', '2024-01-01');
url.searchParams.set('updated_to', 'example');
url.searchParams.set('updated_from', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-offs")
	q := baseURL.Query()
	q.Set("limit", "200")
	q.Set("offset", "0")
	q.Set("end_date", "2024-12-31")
	q.Set("employees", "example")
	q.Set("start_date", "2024-01-01")
	q.Set("updated_to", "example")
	q.Set("updated_from", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-offs")
uri.query = URI.encode_www_form({
  "limit" => "200",
  "offset" => "0",
  "end_date" => "2024-12-31",
  "employees" => "example",
  "start_date" => "2024-01-01",
  "updated_to" => "example",
  "updated_from" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/personio.de/personnel/1.0/company/time-offs?" . http_build_query([
    "limit" => "200",
    "offset" => "0",
    "end_date" => "2024-12-31",
    "employees" => "example",
    "start_date" => "2024-01-01",
    "updated_to" => "example",
    "updated_from" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Personnel Data?

Personnel Data is a Company API. Developers commonly use company APIs for:

enriching CRM records with company firmographics
building lead-generation and prospecting tools
verifying business identity and registration details
monitoring competitors and market intelligence
powering B2B data enrichment pipelines

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Personnel Data is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗