Public Holidays
FreeYour agent guesses which days are holidays; this returns the real public-holiday calendar by country and year.
Time
Use when
You need accurate public holidays for scheduling, business-day logic, or to gate a job on a date instead of guessing.
Not for
Company or personal calendars, religious-calendar conversion, long-weekend detection, event or concert dates, or weekend and business-day counting on their own.
What you can do
Each is a sub-skill of Public Holidays; the router picks the right one for your request.
What you get back
information
Returns dates and holiday names, a yes or no with the holiday name for a single date, or the set of supported countries and their regions. Not a downloadable file.
When it checks with you first
The request could mean check one date or list a whole year, and which one is wanted is unclear.
Run it
Skills run through one gateway with your Faro token. Hand it an intent in plain language; Faro routes to the right sub-skill, runs it, and bills per call.
curl -X POST "https://skill.askfaro.com/skills/holidays/run" \
-H "Authorization: Bearer $FARO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"intent":{"prompt":"What are the public holidays in the US in 2026?"}}'Example requests
- ›What are the public holidays in the US in 2026?
- ›Is 2026-07-04 a holiday in the US?
- ›When is the next public holiday in France?
- ›Which countries have holiday data?