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