🎉Public Holidays (Live)
List upcoming or full-year public holidays for any covered country via Nager.Date — names, dates and whether they're nationwide. Essential for scheduling agents.
Worked examples
Upcoming in Germany
GET /api/v1/live/holidays?country=DE&op=next&count=8
Result: 8 public holidays — DE
US holidays 2026
GET /api/v1/live/holidays?country=US&op=year&year=2026&count=12
Result: 12 public holidays — US
Upcoming in Brazil
GET /api/v1/live/holidays?country=BR&op=next&count=5
Result: 5 public holidays — BR
Machine API (x402)
$0.002 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/live/holidays?country=DE&op=next&count=8 HTTP/1.1
Host: agenttools-hub.vercel.app
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "live/holidays",
"input": {"country":"DE","op":"next","count":8},
"result": { "value": null, "answer": "8 public holidays — DE" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
Public-holiday calendars from Nager.Date covering roughly 110 countries: upcoming holidays or a full-year list, with local and English names and nationwide/regional scope. Cached 12 hours.
Frequently asked questions
Which countries are covered?
About 110 countries with official public-holiday calendars (all of Europe, the Americas, much of Asia and Oceania). Unsupported codes return a clear error.
What does 'regional' mean?
Some holidays apply only to certain states or regions; the `global` flag distinguishes nationwide holidays from regional ones.