Reference: Rest breaks
Statutory minimum break for a working time, for adults and young employees.
Calculates the statutory minimum break (Ruhepause) for a daily working time under § 4 of the Working Hours Act (ArbZG), and for young employees under § 11 of the Youth Employment Protection Act (JArbSchG). Plus the maximum working time per day, the rest period before the next working day and a note if the working time is above the statutory limit.
Endpoints and calls
#| Access | Call |
|---|---|
| REST API | GET /hr/pausen |
| SDK JavaScript | qk.hr.pausen(…) |
| SDK Python | qk.hr.pausen(…) |
| CLI | qk pausen --arbeitszeit-stunden 9.5 |
| MCP tool | hr_pausen |
Parameters
#| Name | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
arbeitszeit_stunden | number | yes | 0.25 to 24 | Daily working time in hours without breaks, for example 7.5 | |
jugendlich | true or false | no | false | true for employees aged 15 to under 18 (Youth Employment Protection Act). Children under 15 may generally not be employed (§ 5 JArbSchG). 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 |
arbeitszeit_stunden | Decimal | Daily working time without breaks in hours |
jugendlich | Boolean | Whether the Youth Employment Protection Act (JArbSchG) was applied |
pause_minuten | Integer | Statutory minimum break in minutes |
anwesenheit_stunden | Decimal | Working time plus minimum break in hours |
hoechstens_ohne_pause_stunden | Decimal | Longest working stretch allowed without a break |
mindestdauer_abschnitt_minuten | Integer | Shortest break segment that counts as a rest break |
hoechstarbeitszeit_tag_stunden | Decimal | Regular maximum working time per day |
hoechstarbeitszeit_tag_ausnahme_stunden | Decimal | Maximum working time per day with compensation |
ruhezeit_stunden | Integer | Uninterrupted rest period after the end of work |
warnungen | List | Notes if the working time exceeds a statutory limit |
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 |
Example
#Call with arbeitszeit_stunden = 9.5. The response is generated by the same code that answers the API.
Error cases
#| Status | Code | When |
|---|---|---|
| 400 | parameter_fehlt | if arbeitszeit_stunden is missing |
| 400 | ungueltiger_parameter | wrong format or a value outside: arbeitszeit_stunden (0.25 to 24) |
| 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_pausen:
Source and freshness
#| Item | Content |
|---|---|
| Source | §§ 3 to 5 ArbZG, §§ 8, 11 and 13 JArbSchG |
| 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 24, 2026 |
| Next expected change | only if the law changes |
Something missing or unclear? Write to us and we will extend the docs.