Official HR values for your software

German social security values, minimum wage and public holidays as an API

German minimum wage, social security ceilings and contribution rates, tax-free allowances, travel expenses, deadlines, public holidays and working days via API, SDK, CLI and MCP server. Built for payroll and HR software, AI agents and global payroll and EOR providers with employees in Germany. Every value with its legal basis (Rechtsgrundlage), an official source and the day it takes effect.

Start for free →Quickstart

500 requests a month free, no credit card.

23Datasets

4Access methods

2015Tables since

weeklychecked against sources

api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15

Zur API-Doku →

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15" \
  -H "Authorization: Bearer $QK_KEY"

{
  "gueltig_ab": "2027-01-01",
  "mindestlohn_brutto_stunde": 14.6,
  "minijob_grenze_monat": 633,
  "rechtsgrundlage": "Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268), Stufe 2"
}

import { Quellenkontor } from "@quellenkontor/sdk";

const qk = new Quellenkontor(process.env.QK_KEY);
const frist = await qk.hr.kuendigungsfrist({ eintritt: "2017-03-01", zugang: "2026-11-10" });

console.log(frist.ende); // "2027-02-28"

$ npm install -g @quellenkontor/cli
$ qk login
$ qk mindestlohn --datum 2027-01-15
datensatz                  mindestlohn
datum                      2027-01-15
mindestlohn_brutto_stunde  14.6
minijob_grenze_monat       633
gueltig_ab                 2027-01-01
…

$ qk feiertage --jahr 2027 --land HE --format csv > feiertage.csv

$ claude mcp add --transport http quellenkontor \
    https://mcp.quellenkontor.dev/v1 \
    --header "Authorization: Bearer $QK_KEY"

# Tools: hr_mindestlohn, hr_kuendigungsfrist, hr_feiertage and more

Query for January 15, 2027: the adopted minimum wage is already available, with the ordinance and its citation in the Federal Law Gazette (Bundesgesetzblatt).

Minimum Wage Act (Mindestlohngesetz)Social Security Reference Values Ordinance (Sozialversicherungsrechengrößen-Verordnung)Social Insurance Remuneration Ordinance (Sozialversicherungsentgeltverordnung)§ 622 Civil Code (BGB)Federal Leave Act (Bundesurlaubsgesetz)Maternity Protection Act (Mutterschutzgesetz)State public holiday laws (Feiertagsgesetze)§ 850c Code of Civil Procedure (ZPO)§ 20 Social Code Book IV (SGB IV)Federal Law Gazette (Bundesgesetzblatt)Minimum Wage Act (Mindestlohngesetz)Social Security Reference Values Ordinance (Sozialversicherungsrechengrößen-Verordnung)Social Insurance Remuneration Ordinance (Sozialversicherungsentgeltverordnung)§ 622 Civil Code (BGB)Federal Leave Act (Bundesurlaubsgesetz)Maternity Protection Act (Mutterschutzgesetz)State public holiday laws (Feiertagsgesetze)§ 850c Code of Civil Procedure (ZPO)§ 20 Social Code Book IV (SGB IV)Federal Law Gazette (Bundesgesetzblatt)

How we verify

AI agents guess numbers. Yours should cite them.

Language models often give outdated values for the minimum wage, deadlines or contribution ceilings. Quellenkontor delivers every value with its legal basis, source and validity, and every response with a ready-made sentence to cite. How we verify the values.

What is the German minimum wage on January 15, 2027?

Without a data sourceexample, outdated

The statutory minimum wage in Germany is €12.41 gross per hour.

This is how a language model with knowledge up to 2024 answers: confident, no source, with the value from back then.

With Quellenkontor via MCPwith source

Gesetzlicher Mindestlohn in Deutschland am 15.01.2027: 14,60 Euro brutto je Stunde, gültig ab 01.01.2027. Minijob-Grenze: 633 Euro im Monat. Rechtsgrundlage: Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025, Stufe 2. Quelle: Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268), https://www.recht.bund.de/bgbl/1/2025/268/VO.html. Daten: Quellenkontor (quellenkontor.dev).

This sentence is in the zitat field of every response (in German, as the API returns it), and the agent quotes it word for word.

An official source for every value

Law, ordinance or official notice with a link, plus the legal basis.

Sources and licenses →

Checked every week

All datasets against the primary sources, most recently on September 24, 2026.

Status by dataset →

An open changelog

Every new, changed or corrected value with date and evidence.

Changelog →

Report an error

If a value doesn't match the source, we check it against the primary source.

Report an error →

Why not maintain it yourself

What you'd otherwise track down yourself

These changes are coming next. Quellenkontor enters them once they're promulgated, your software just queries. What maintaining them yourself costs a year.

Dataset	Next expected change
Minimum wage and mini-job limit	Minimum Wage Commission (Mindestlohnkommission) decision for 2028 due by June 30, 2027
Apprentice minimum pay	Notice for training starting in 2027 due by November 1, 2026
Care minimum wage	Steps through July 1, 2027 already promulgated, the ordinance runs through September 30, 2028
Social security reference values	Ordinance for 2027 in fall 2026; from 2027, compulsory insurance threshold plus €3,600 and separate thresholds for health and long-term care insurance (GKV-Beitragssatzstabilisierungsgesetz)
Social security contribution rates	Average additional contribution for 2027 due by November 1, 2026; surcharge for spouses with family insurance entered from January 1, 2028
Meal and accommodation values	Amending ordinance for 2027 in fall 2026
Wage garnishment exemptions	Notice for July 1, 2027 in spring 2027
Midi-job transition zone	Factor F for 2027 due by December 31, 2026, from 2027 under the new formula (GKV-Beitragssatzstabilisierungsgesetz)
Mini-job levies: flat-rate charges for employers	Commercial health insurance rate from 2027 once the additional contribution is announced, U1 and U2 levies in December
Artists' social security levy	Rate for 2027 is set, ordinance for 2028 in fall 2027
Disability compensatory levy	Adjustment for 2027 in the Federal Gazette (Bundesanzeiger), if the reference value has risen by 10 percent
Tax-free amounts and employee expense allowances	On promulgation of a tax law, usually at year end
Domestic travel expenses	On a change to § 9 EStG or the Federal Travel Expenses Act (Bundesreisekostengesetz)
Income tax: basic allowance and bracket thresholds	2027 schedule once the tax law is promulgated

Datasets

What you can query

All 23 datasets →

Minimum wage and mini-job limit

Statutory minimum wage (Mindestlohn) and mini-job earnings limit (Geringfügigkeitsgrenze) for any date since 2015.

APIMCPwith every adjustment

Apprentice minimum pay

Statutory minimum pay for apprentices (Mindestausbildungsvergütung) per training year, by start of training since 2020.

APIMCPyearly, announced by November 1

Social security reference values

Contribution ceilings, compulsory insurance threshold and reference value per year, West and East.

APIMCPyearly on January 1

Social security contribution rates

Health, pension, unemployment and long-term care insurance with employer and employee share.

APIMCPyearly and with every change

Tax-free amounts and employee expense allowances

Tax-free limit for benefits in kind (€50 limit), company events and other allowances, plus the employee lump sum, home office and commuter allowance since 2015.

APIMCPwith every change in the law

Domestic travel expenses

Meal allowances (Verpflegungsmehraufwand), overnight stays and mileage allowance for business trips in Germany since 2015.

APIMCPwhen the law changes

Notice period calculator

Statutory notice period and end date under § 622 BGB from start date and date of receipt.

APIMCPwhen the law changes

Vacation entitlement calculator

Statutory minimum vacation for part-time work and for joining or leaving during the year.

APIMCPwhen the law changes

Public holidays

Public holidays by state and year, with regional holidays marked.

APIMCPwhen the law changes

Working days calculator

Working days between two dates by state, without weekends and public holidays.

APIMCPwhen the law changes

Access methods

Four access methods, one dataset

Use the data wherever you work: in code, in the terminal or in your agent.

API

REST interface: every dataset for every effective date, plus history and CSV.

Docs →

SDK

Packages for JavaScript and Python, with a timeout and retries.

Docs →

CLI

Query values in the terminal, export as CSV, build them into scripts.

Docs →

MCP

Tools for Claude Code, Cursor and your own agents, with a source in every response.

Docs →

Solutions

Who Quellenkontor is built for

All solutions →

For HR software

Public holidays, notice periods, vacation and maternity protection in your product, without maintaining the rules yourself.

Solution →

For payroll software and payroll providers

Social security thresholds, contribution rates, benefits in kind and garnishment limits with valid-from dates, ahead of each change.

Solution →

For AI agents and HR chatbots

Values with a source instead of guessed numbers, through the MCP server.

Solution →

Use cases

Ways to put Quellenkontor to work

All use cases →

Use case

Automate year-end changes in payroll

Pick up new ceilings and rates automatically before they apply.

Use case

Answer statutory notice periods in an HR chatbot, with legal basis

The agent calls the calculator and gives the notice period, end date and legal basis.

Use case

Account for public holidays by location in shift planning

Public holidays for each location in the plan automatically, regional holidays included.

Questions

Frequently asked questions

Where does the data come from?

From laws, ordinances and official announcements. Every value states its legal basis and source, usually the Federal Law Gazette (Bundesgesetzblatt), the Federal Gazette (Bundesanzeiger) or gesetze-im-internet.de.

How current are the values?

Every week we check all datasets against the official sources and add newly published values, usually weeks before they apply. Every change is recorded in the changelog, and on the Pro plan and above a webhook reports it the next morning.

Is this legal advice?

No. Quellenkontor provides values from official sources and schematic calculations under the law. You check the individual case yourself.

Which AI applications work with the MCP server?

Tested with Claude Code, Cursor and VS Code. Other clients that connect to remote MCP servers over HTTP with a custom header work as well.

Is there a free plan?

Yes. 1,000 requests a month for all datasets and all access methods, no credit card required.

Your first query in five minutes

500 requests a month free. No credit card.

Get an API key →