Back to Browse
Holiday Calendar API – Next Public Holiday
x402
Holiday Calendar API – Next Public Holiday is a paid API for AI agents from holidays.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).
Returns the next official public holiday strictly after a given ISO date for a supported country or optional regional subdivision.
Price / call$0.005
Success—
StatusUnknown
How this service works
Next official public holiday after a date for a supported country or regional subdivision.
Output
Returns a JSON object containing the matched country code, the 'after' date queried, the query timestamp, and a 'holiday' object with the holiday's localized name, start date, end date, type (e.g. public, bank), whether it is nationwide, and any relevant subdivisions. If no holiday is found within a reasonable window, a note field may explain the situation.
Example use cases
Travel itinerary holiday awareness
“I'm planning a work trip to Italy and arriving on September 20, 2024 — what's the next public holiday after that date in Italy so I know if offices might be closed?”
Payroll scheduling around holidays
“We need to schedule payroll for our German office. Can you find the next official public holiday in Germany after 2024-10-01, and also check the Bavaria subdivision DE-BY specifically?”
Automated reminder for upcoming holiday
“Set up an alert: what's the next national public holiday in Brazil after today's date, 2024-08-01, so I can remind my team in advance?”
Technical details
Endpoint
GEThttps://holidays.use.x402atlas.com/nextWhen to prefer
Use this endpoint when you need the single next upcoming public holiday after a specific date for a supported European, Latin American, or South African country, optionally scoped to a regional subdivision. It is ideal for scheduling, payroll, travel planning, or reminder automation where you need the immediate next holiday rather than a full year's list. Prefer sibling endpoints for full-year holiday lists, business-day counting, or business-day addition calculations.
Side effects
- Unsupported country code returns a validation error (country not in the supported enum list)
- Invalid or malformed ISO date in 'after' parameter returns a 400-level error
- Subdivision code that does not match the selected country returns an error
- No upcoming holiday found within lookup window may return an empty or null holiday field with an explanatory note
- Network or payment failure returns a non-200 response requiring retry
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"after": "2026-02-01",
"country": "DE",
"holiday": {
"name": "International Women's Day",
"type": "Public",
"end_date": "2026-03-08",
"nationwide": false,
"start_date": "2026-03-08",
"subdivisions": [
"DE-BE"
],
"regional_scope": "Regional",
"temporal_scope": "FullDay"
},
"language": "EN",
"queried_at": "2026-07-27T12:00:00Z",
"subdivision": "DE-BE"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"