Endpoint
GET https://requiems.xyz/v1/systems/business-calendar/{country}
Business Calendar
Retrieve working days, public holidays, and next upcoming holiday for any country and optional year/month. Covers 100+ countries.
Parameters
| Name |
Type |
Required |
Location |
Description |
country |
string |
yes |
path |
ISO 3166-1 alpha-2 country code (e.g. DE, US, FR) |
year |
integer |
no |
query |
Year to retrieve the calendar for. Defaults to the current year. |
month |
integer |
no |
query |
Month (1–12). When provided, returns month-scoped working day count, total days, weekend days, and filtered holidays. |
Request Example
GET /v1/systems/business-calendar/DE?year=2026&month=6
Response Example
{
"data": {
"country_code": "DE",
"year": 2026,
"month": 6,
"working_days": 21,
"total_days": 30,
"weekend_days": 8,
"holidays": [],
"holiday_count": 0,
"next_holiday": {
"date": "2026-10-03",
"name": "German Unity Day",
"type": "national"
}
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field |
Type |
Description |
country_code |
string |
ISO 3166-1 alpha-2 country code echoed from the path parameter |
year |
integer |
Year the calendar covers |
month |
integer |
Month scope. Present only when the month query parameter was provided. |
working_days |
integer |
Number of working days (excluding weekends and public holidays) in the scope |
total_days |
integer |
Total calendar days in the month. Present only when month is provided. |
weekend_days |
integer |
Number of weekend days in the month. Present only when month is provided. |
holidays |
array |
List of public holidays in the scope. Each item: {date: YYYY-MM-DD, name: string, type: national} |
holiday_count |
integer |
Count of holidays in the holidays array |
next_holiday |
object |
Next public holiday within 90 days from today. Shape: {date, name, type} |
Errors
undefined 422 — Country is not a 2-letter ISO code, or year/month is out of the valid rangeundefined 401 — Missing or invalid API key
1---2name: global-data-get-country3description: Retrieve working days, public holidays, and next upcoming holiday for any country and optional year/month. Covers 100+ countries.4---5
6## Endpoint
7
8**GET https://requiems.xyz/v1/systems/business-calendar/{country}**
9
10## Business Calendar
11
12Retrieve working days, public holidays, and next upcoming holiday for any country and optional year/month. Covers 100+ countries.
13
14## Parameters
15
16| Name | Type | Required | Location | Description |
17| ---- | ---- | -------- | -------- | ----------- |
18| `country` | string | yes | path | ISO 3166-1 alpha-2 country code (e.g. DE, US, FR) |
19| `year` | integer | no | query | Year to retrieve the calendar for. Defaults to the current year. |
20| `month` | integer | no | query | Month (1–12). When provided, returns month-scoped working day count, total days, weekend days, and filtered holidays. |
21
22## Request Example
23
24```json
25GET /v1/systems/business-calendar/DE?year=2026&month=6
26```
27
28## Response Example
29
30```json
31{
32 "data": {
33 "country_code": "DE",
34 "year": 2026,
35 "month": 6,
36 "working_days": 21,
37 "total_days": 30,
38 "weekend_days": 8,
39 "holidays": [],
40 "holiday_count": 0,
41 "next_holiday": {
42 "date": "2026-10-03",
43 "name": "German Unity Day",
44 "type": "national"
45 }
46 },
47 "metadata": {
48 "timestamp": "2026-01-01T00:00:00Z"
49 }
50}
51```
52
53## Response Fields
54
55| Field | Type | Description |
56| ----- | ---- | ----------- |
57| `country_code` | string | ISO 3166-1 alpha-2 country code echoed from the path parameter |
58| `year` | integer | Year the calendar covers |
59| `month` | integer | Month scope. Present only when the month query parameter was provided. |
60| `working_days` | integer | Number of working days (excluding weekends and public holidays) in the scope |
61| `total_days` | integer | Total calendar days in the month. Present only when month is provided. |
62| `weekend_days` | integer | Number of weekend days in the month. Present only when month is provided. |
63| `holidays` | array<object> | List of public holidays in the scope. Each item: {date: YYYY-MM-DD, name: string, type: national} |
64| `holiday_count` | integer | Count of holidays in the holidays array |
65| `next_holiday` | object | Next public holiday within 90 days from today. Shape: {date, name, type} |
66
67## Errors
68
69- `undefined` **422** — Country is not a 2-letter ISO code, or year/month is out of the valid range
70- `undefined` **401** — Missing or invalid API key
gabrielmoreira