# Public Holidays

> Skill `holidays` on Faro. 4 sub-skills.

Your agent guesses which days are holidays; this returns the real public-holiday calendar by country and year.

**Category:** Time  
**Tags:** holidays, public-holidays, calendar, business-days  
**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.  
**Returns:** 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.

## How to run
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. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/holidays/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What are the public holidays in the US in 2026?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run holidays "What are the public holidays in the US in 2026?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## 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?

## Sub-skills

### List holidays

Lists every public holiday for a country in a given year.

**Cost:** 0.1 credits / lookup

**Use when:** You want the full holiday calendar for a country and year to build a schedule or do business-day math.

**Details:** https://askfaro.com/llms/skills/holidays/list.md

---

### Check a date

Says whether a specific date is a public holiday in a country, and names it.

**Cost:** 0.1 credits / lookup

**Use when:** You want a single yes or no for one date, such as gating a scheduled job or a working-day check.

**Details:** https://askfaro.com/llms/skills/holidays/is_holiday.md

---

### Next holidays

Lists the next upcoming public holidays for a country, in date order.

**Cost:** 0.1 credits / lookup

**Use when:** You want the next holiday, or the next few, looking ahead from today or a given day.

**Details:** https://askfaro.com/llms/skills/holidays/next.md

---

### Supported countries

Lists the supported countries and the regional subdivisions available for each.

**Cost:** 0.1 credits / lookup

**Use when:** You want to know which countries are covered, or to confirm a country or region code before querying.

**Details:** https://askfaro.com/llms/skills/holidays/countries.md

---

---
On the web: https://askfaro.com/search/holidays