API URL
GET /api/v1/calendar/month
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
year
optional
number
Year input for month and holidays endpoints
month
optional
number
Month input from 1 to 12
date
optional
string
ISO date for day endpoint
week_start
optional
string
Week boundary mode monday or sunday
timezone
optional
string
Timezone value returned in metadata
include_holidays
optional
boolean
Enable holiday enrichment
country_code
optional
string
ISO2 country code for public holiday source
output_format
optional
string
Output format flat or nested
Example GET Request
Code
GET https://datpaq.com/api/v1/calendar/month?api_key=your-api-key&year=2026&month=8Successful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"data": {
"date": "2026-06-29",
"year": 2026,
"month": 6,
"day_name": "Monday"
},
"meta": {
"timezone": "UTC"
},
"correlationId": "4a4a0dc0-52ea-4c9f-89c7-3c0c4c6d4f2a"
}Field
Type
success
boolean
data
object
data.year
number
data.month
number
data.date
string
data.days
array
data.weeks
array
data.holidays
array
data.count
number
meta
object
meta.timezone
string
meta.holiday_summary
object
correlationId
string
error
string
details
array
retryAfter
number
Error Response
Example
Code
400 ValidationError - Invalid query values semantic checks or malformed custom_holidays input: Returns structured validation error with details array
401 AuthenticationError - Gateway rejects missing or invalid API key: Request denied before business handler returns success payload
403 AuthorizationError - Gateway blocks authenticated caller by policy: Request denied by access control policy
404 NotFound - Route not implemented: Returns Endpoint not found response
429 RateLimitExceeded - Limit exceeded on /api/* window: Returns Too many requests with retryAfter
502 UpstreamUnavailable - Public holiday source required and upstream call fails: Returns Holiday source unavailable error
500 InternalError - Unhandled runtime failure in route handler: Returns endpoint specific failure messageLast Updated: May 4, 2026