Reference

Reference: SV due dates

Monthly contribution statement deadline and payment date for German social security, based on your collecting agency's state.

Calculates, for each month, the third-last bank business day on which total social security contributions are due, and the deadline for the contribution statement (Beitragsnachweis). Saturdays, Sundays, public holidays at the collecting agency's seat, and December 24 and 31 are not bank business days. Without a state, the calculator shows the months in which dates differ by state.

Endpoints and calls

Access	Call
REST API	`GET /hr/sv-faelligkeit`
SDK JavaScript	`qk.hr.svFaelligkeit(…)`
SDK Python	`qk.hr.sv_faelligkeit(…)`
CLI	`qk sv-faelligkeit --jahr 2027 --land HH`
MCP tool	`hr_sv_faelligkeit`

Parameters

Name	Type	Required	Default	Allowed	Description
`jahr`	year	no	laufendes Jahr	2015 to 2035	Calendar year 2015 to 2035, returns all twelve months. Default: current year
`datum`	date (YYYY-MM-DD)	no			Alternative to jahr: reference date as YYYY-MM-DD, returns only that month
`land`	text	no		BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH	State of the collecting agency (health insurance fund), for example HH. Without it: shared dates plus deviations by state per month

The API rejects unknown parameters with unbekannter_parameter. In addition there are format and trennzeichen, see CSV.

Response fields

Field	Type	Meaning
`datensatz`	Text	Dataset id
`jahr`	Integer	Calendar year
`land`	Text or null	State code
`land_name`	Text	Name of the state
`termine`	List	Per month: faelligkeit, nachweis_vorliegen, nachweis_uebermitteln_bis and nicht_bankarbeitstage
`rechtsgrundlage`	Text	Law or ordinance
`quelle`	Object	Title and URL of the source the value is based on
`quellen`	List	All legal provisions the response is based on, with title and URL
`hinweise`	List	Limits of the values or the calculation, in sentences
`stand`	Date	Date of the last check against the source
`lizenz`	Text	Terms of use for the values
`zitat`	Text	Ready-made sentence for citing, with value, validity, legal basis and source
`datenstand`	Text	Id of the data snapshot: date and sequence number of the last changelog entry (/v1/aenderungen) affecting this dataset. The same datenstand means unchanged content, useful for auditors and for comparing two requests
`abweichungen`	List	Without land: dates per group of states
`einheitlich`	Wahrheitswert	Without land: true if all states have the same dates

Example

Call with jahr = 2027, land = HH. The response is generated by the same code that answers the API.

api.quellenkontor.dev/v1/hr/sv-faelligkeit?jahr=2027&land=HH

Zur API-Doku →

curl "https://api.quellenkontor.dev/v1/hr/sv-faelligkeit?jahr=2027&land=HH" \
  -H "Authorization: Bearer $QK_KEY"

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

const qk = new Quellenkontor(process.env.QK_KEY);
const daten = await qk.hr.svFaelligkeit({ jahr: 2027, land: "HH" });

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])
daten = qk.hr.sv_faelligkeit(jahr=2027, land="HH")

$ qk sv-faelligkeit --jahr 2027 --land HH

{
  "name": "hr_sv_faelligkeit",
  "arguments": {
    "jahr": 2027,
    "land": "HH"
  }
}

This is how an agent calls the tool. Server setup is described in the MCP docs.

Antwort200 OK · JSON

{
  "datensatz": "sv-faelligkeit",
  "jahr": 2027,
  "land": "HH",
  "land_name": "Hamburg",
  "termine": [
    {
      "monat": "2027-01",
      "faelligkeit": "2027-01-27",
      "nachweis_vorliegen": "2027-01-25",
      "nachweis_uebermitteln_bis": "2027-01-24",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-02",
      "faelligkeit": "2027-02-24",
      "nachweis_vorliegen": "2027-02-22",
      "nachweis_uebermitteln_bis": "2027-02-21",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-03",
      "faelligkeit": "2027-03-25",
      "nachweis_vorliegen": "2027-03-23",
      "nachweis_uebermitteln_bis": "2027-03-22",
      "nicht_bankarbeitstage": [
        {
          "datum": "2027-03-26",
          "name": "Karfreitag"
        },
        {
          "datum": "2027-03-29",
          "name": "Ostermontag"
        }
      ]
    },
    {
      "monat": "2027-04",
      "faelligkeit": "2027-04-28",
      "nachweis_vorliegen": "2027-04-26",
      "nachweis_uebermitteln_bis": "2027-04-25",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-05",
      "faelligkeit": "2027-05-27",
      "nachweis_vorliegen": "2027-05-25",
      "nachweis_uebermitteln_bis": "2027-05-24",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-06",
      "faelligkeit": "2027-06-28",
      "nachweis_vorliegen": "2027-06-24",
      "nachweis_uebermitteln_bis": "2027-06-23",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-07",
      "faelligkeit": "2027-07-28",
      "nachweis_vorliegen": "2027-07-26",
      "nachweis_uebermitteln_bis": "2027-07-25",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-08",
      "faelligkeit": "2027-08-27",
      "nachweis_vorliegen": "2027-08-25",
      "nachweis_uebermitteln_bis": "2027-08-24",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-09",
      "faelligkeit": "2027-09-28",
      "nachweis_vorliegen": "2027-09-24",
      "nachweis_uebermitteln_bis": "2027-09-23",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-10",
      "faelligkeit": "2027-10-27",
      "nachweis_vorliegen": "2027-10-25",
      "nachweis_uebermitteln_bis": "2027-10-24",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-11",
      "faelligkeit": "2027-11-26",
      "nachweis_vorliegen": "2027-11-24",
      "nachweis_uebermitteln_bis": "2027-11-23",
      "nicht_bankarbeitstage": []
    },
    {
      "monat": "2027-12",
      "faelligkeit": "2027-12-28",
      "nachweis_vorliegen": "2027-12-23",
      "nachweis_uebermitteln_bis": "2027-12-22",
      "nicht_bankarbeitstage": [
        {
          "datum": "2027-12-24",
          "name": "Heiligabend (kein Bankarbeitstag)"
        },
        {
          "datum": "2027-12-31",
          "name": "Silvester (kein Bankarbeitstag)"
        }
      ]
    }
  ],
  "rechtsgrundlage": "§ 23 Abs. 1 Satz 2 SGB IV (drittletzter Bankarbeitstag), § 28f Abs. 3 SGB IV (Beitragsnachweis zwei Arbeitstage vor Fälligkeit)",
  "quelle": {
    "titel": "§ 23 SGB IV (Fälligkeit)",
    "url": "https://www.gesetze-im-internet.de/sgb_4/__23.html"
  },
  "quellen": [
    {
      "titel": "§ 23 SGB IV (Fälligkeit)",
      "url": "https://www.gesetze-im-internet.de/sgb_4/__23.html"
    },
    {
      "titel": "§ 28f SGB IV (Aufzeichnungspflicht, Nachweise der Beitragsabrechnung und der Beitragszahlung)",
      "url": "https://www.gesetze-im-internet.de/sgb_4/__28f.html"
    },
    {
      "titel": "Gemeinsame Grundsätze für die Übermittlung der Beitragsnachweise, gültig ab 01.01.2026",
      "url": "https://www.gkv-datenaustausch.de/media/dokumente/arbeitgeber/beitragsnachweise/GG_BNA_202601.pdf"
    }
  ],
  "hinweise": [
    "Die Beiträge müssen am Fälligkeitstag auf dem Konto der Einzugsstelle sein (Tag der Wertstellung).",
    "Der Beitragsnachweis muss zu Beginn des fünftletzten Bankarbeitstags um 0 Uhr vorliegen, also spätestens am Vortag bis 24 Uhr übermittelt sein.",
    "Maßgeblich sind die Feiertage am Sitz der Einzugsstelle, nicht am Sitz des Betriebs. Setze land auf das Land der Krankenkasse.",
    "Der 24. und 31. Dezember gelten nicht als Bankarbeitstage. Das Gesetz definiert den Begriff nicht, der Rechner folgt der übereinstimmenden Praxis der Einzugsstellen.",
    "Regionale Feiertage, die nur in Teilen eines Landes gelten, sind nicht berücksichtigt."
  ],
  "stand": "2026-09-26",
  "lizenz": "Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor.",
  "zitat": "Sozialversicherungsbeiträge 2027-01 für Einzugsstellen mit Sitz in Hamburg: fällig am 27.01.2027, Beitragsnachweis muss am 25.01.2027 um 0 Uhr vorliegen. Weitere Monate in termine. Rechtsgrundlage: § 23 Abs. 1 Satz 2 SGB IV (drittletzter Bankarbeitstag), § 28f Abs. 3 SGB IV (Beitragsnachweis zwei Arbeitstage vor Fälligkeit). Quelle: § 23 SGB IV (Fälligkeit), https://www.gesetze-im-internet.de/sgb_4/__23.html. Daten: Quellenkontor (quellenkontor.dev).",
  "datenstand": "2026-09-26.19"
}

Error cases

Status	Code	When
400	`ungueltiger_parameter`	wrong format or a value outside: jahr (2015 to 2035); land (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH)
400	`unbekannter_parameter`	a parameter this dataset does not have
404	`kein_wert`	outside the coverage (2015 to 2035) or the value for this period has not been promulgated yet
401, 429	see errors	all error codes

Schema for MCP

This is how the MCP server describes the arguments of the tool hr_sv_faelligkeit:

inputSchema

{
  "type": "object",
  "properties": {
    "jahr": {
      "description": "Kalenderjahr 2015 bis 2035, liefert alle zwölf Monate. Ohne Angabe gilt das laufende Jahr.",
      "type": "integer",
      "minimum": 2015,
      "maximum": 2035,
      "examples": [
        2027
      ]
    },
    "datum": {
      "description": "Alternativ zu jahr: Stichtag im Format JJJJ-MM-TT, liefert nur den Monat des Stichtags.",
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "land": {
      "description": "Land am Sitz der Einzugsstelle (Krankenkasse), zum Beispiel HH. Ohne Angabe: gemeinsame Termine und je Monat die Abweichungen nach Ländern",
      "type": "string",
      "enum": [
        "BW",
        "BY",
        "BE",
        "BB",
        "HB",
        "HH",
        "HE",
        "MV",
        "NI",
        "NW",
        "RP",
        "SL",
        "SN",
        "ST",
        "SH",
        "TH"
      ],
      "examples": [
        "HH"
      ]
    }
  },
  "required": [],
  "additionalProperties": false
}

Source and freshness

Item	Content
Source	§ 23 (1) and § 28f (3) SGB IV, joint principles for contribution statements (Gemeinsame Grundsätze Beitragsnachweis)
License	Calculation under the cited provisions. Use under the Quellenkontor terms of use.
Updates	follows the calendar
Coverage	Germany, 2015 to 2035
Last checked	September 26, 2026
Next expected change	yearly check against the collecting agencies' due date lists in December

Overview with tables and questions about the dataset: Social security contribution due dates. Report an error through the contact form.

Something missing or unclear? Write to us and we will extend the docs.