API URL
GET /api/v1/public-holidays
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
country
optional
string
Country selector supporting ISO2, ISO3, full names, and comma-separated values
year
optional
number
Year filter
month
optional
number
Month filter (1-12)
start_date
optional
string
Date-range start in YYYY-MM-DD
end_date
optional
string
Date-range end in YYYY-MM-DD
format
optional
string
Output format: json or csv
Example GET Request
Code
GET https://datpaq.com/api/v1/public-holidays/countries?api_key=your-api-keySuccessful Response
Status
HTML
200 OKBody
Code
{
"countries": [
"US"
],
"filters": {
"year": 2026
},
"holidays": [
{
"date": "2026-12-25T00:00:00.000Z",
"country": "US",
"holiday_name": "Christmas Day"
}
],
"count": 1,
"correlationId": "req-abc123"
}Field
Type
countries
array
filters
object
filters.year
number
filters.month
number
filters.date_range
object
holidays
array
count
number
timestamp
string
correlationId
string
code
string
name
string
iso3
string
numericcode
string
error
string
message
string
Error Response
Example
Code
400 ValidationError - Country input resolves to zero valid country codes: Request rejected with validation guidance
404 NotFound - CSV format requested and query returns no rows: No holiday rows available for requested criteria
500 InternalError - Country or holiday query processing fails: Generic processing failure response
504 QueryTimeout - Holiday query exceeds 30-second timeout wrapper: Client should reduce date span or country scope
401 AuthenticationError - Missing or invalid API key at gateway layer: Authentication enforced by gateway middlewareLast Updated: May 4, 2026