Reference: Notice period
Statutory notice period and end date under § 622 BGB from start date and date of receipt.
Calculates the statutory notice period (Kündigungsfrist) under § 622 of the Civil Code (BGB) and the date on which the employment ends. Takes into account length of service, probation and the calculation of time limits under §§ 187 and 188 BGB.
Endpoints and calls
#| Access | Call |
|---|---|
| REST API | GET /hr/kuendigungsfrist |
| SDK JavaScript | qk.hr.kuendigungsfrist(…) |
| SDK Python | qk.hr.kuendigungsfrist(…) |
| CLI | qk kuendigungsfrist --eintritt 2017-03-01 --zugang 2026-11-10 |
| MCP tool | hr_kuendigungsfrist |
Parameters
#| Name | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
eintritt | date (YYYY-MM-DD) | yes | Start of employment | ||
zugang | date (YYYY-MM-DD) | yes | Date the notice is received, not before the start of employment | ||
seite | text | no | arbeitgeber | arbeitgeber, arbeitnehmer | Who gives notice. Default: arbeitgeber |
probezeit | true or false | no | false | true if a probationary period was agreed. Default: false |
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 |
eintritt | Date | Start of employment |
zugang | Date | Date the notice is received |
seite | Text | arbeitgeber (employer) or arbeitnehmer (employee) |
probezeit | Boolean | Whether the notice period for probation was applied |
betriebszugehoerigkeit_jahre | Integer | Full years of service up to receipt of the notice |
frist | Text | The notice period in words |
frist_code | Text | Machine-readable id of the notice period |
fristende | Date | End of the notice period itself |
ende | Date | Date on which the employment or the protection period ends |
rechtsgrundlage | Text | Law or ordinance |
hinweise | List | Limits of the values or the calculation, in sentences |
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 |
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 |
Example
#Call with eintritt = 2017-03-01, zugang = 2026-11-10. The response is generated by the same code that answers the API.
api.quellenkontor.dev/v1/hr/kuendigungsfrist?eintritt=2017-03-01&zugang=2026-11-10
Zur API-Doku →This is how an agent calls the tool. Server setup is described in the MCP docs.
Error cases
#| Status | Code | When |
|---|---|---|
| 400 | parameter_fehlt | if eintritt or zugang is missing |
| 400 | ungueltiger_parameter | wrong format or a value outside: seite (arbeitgeber, arbeitnehmer) |
| 400 | unbekannter_parameter | a parameter this dataset does not have |
| 404 | kein_wert | outside the coverage (current law) 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_kuendigungsfrist:
Source and freshness
#| Item | Content |
|---|---|
| Source | § 622 BGB, §§ 187 and 188 BGB |
| License | Calculation under the cited provisions. Use under the Quellenkontor terms of use. |
| Updates | when the law changes |
| Coverage | Germany, current law |
| Last checked | September 23, 2026 |
| Next expected change | only if the law changes |
Overview with tables and questions about the dataset: Notice period calculator. Report an error through the contact form.
Something missing or unclear? Write to us and we will extend the docs.