Reference: Maternity protection
Start and end of the maternity protection periods from the expected due date.
Calculates the start and end of the maternity protection periods (Mutterschutzfristen) under § 3 of the Maternity Protection Act (MuSchG) from the expected due date. With the actual date of birth and the case (premature birth, multiple birth, disability), the end shifts automatically. The protection periods after a miscarriage, in force since June 2025, are included.
Endpoints and calls
#| Access | Call |
|---|---|
| REST API | GET /hr/mutterschutz |
| SDK JavaScript | qk.hr.mutterschutz(…) |
| SDK Python | qk.hr.mutterschutz(…) |
| CLI | qk mutterschutz --termin 2027-03-15 |
| MCP tool | hr_mutterschutz |
Parameters
#| Name | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
termin | date (YYYY-MM-DD) | no | Expected due date. Required, except for fall=fehlgeburt | ||
geburt | date (YYYY-MM-DD) | no | Actual date of birth, at most 120 days from the due date. For fall=fehlgeburt, the date of the miscarriage, from June 1, 2025 (optional) | ||
fall | text | no | standard | standard, fruehgeburt, mehrlinge, behinderung, fehlgeburt | Case under § 3 Abs. 2 or Abs. 5 MuSchG. Default: standard |
ssw | integer | no | 1 to 45 | Current week of pregnancy at the miscarriage, only for fall=fehlgeburt. The medical notation 12+3 (twelve full weeks and three days) is the 13th week, so ssw=13. |
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 |
termin | Date or null | Expected due date |
geburt | Date or null | Actual date of birth or date of the miscarriage |
fall | Text | standard, fruehgeburt (premature birth), mehrlinge (multiple birth), behinderung (disability) or fehlgeburt (miscarriage) |
beginn | Date | Start: first day of the protection period (maternity protection) or start of training |
ende | Date | Date on which the employment or the protection period ends |
wochen_nach_entbindung | Integer | 8 or 12, after a miscarriage 2, 6 or 8 |
verlaengerung_tage | Integer | Days added after an early birth |
dauer_tage | Integer | Total length in calendar days |
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 termin = 2027-03-15. The response is generated by the same code that answers the API.
Error cases
#| Status | Code | When |
|---|---|---|
| 400 | ungueltiger_parameter | wrong format or a value outside: fall (standard, fruehgeburt, mehrlinge, behinderung, fehlgeburt); ssw (1 to 45) |
| 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_mutterschutz:
Source and freshness
#| Item | Content |
|---|---|
| Source | § 3 Maternity Protection Act (Mutterschutzgesetz) |
| 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 |
Something missing or unclear? Write to us and we will extend the docs.