Faro
Tools/holidays
Public Holidays

Public Holidays

Active

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

4 tools

Public holidays by country and year: full-year lists, whether a date is a holiday, upcoming holidays, and the set of supported countries. Useful for scheduling, business-day math, and calendar logic.

Timeholidayspublic-holidayscalendarbusiness-days

Tools (4)

▶list

All public holidays for a given country and year, with localized names.

Free

Example prompts

  • “What are the public holidays in the US in 2026?”
  • “List German holidays for next year”
  • “Show all 2025 public holidays for Japan”
  • “Holidays in California specifically”

Parameters

yearintegeroptional

Four-digit year. Defaults to the current year.

countrystringrequired

ISO 3166-1 alpha-2 country code (e.g. US, GB, DE).

languagestringoptional

Optional language code for localized holiday names (e.g. de, fr).

subdivisionstringoptional

Optional ISO 3166-2 subdivision code for regional holidays (e.g. CA, TX, BY).

API Usage

curl -X POST "https://skill.askfaro.com/skills/holidays/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What are the public holidays in the US in 2026?"
  }
}'

CLI Usage

askfaro describe holidays/holidays.list

Install pip install askfaro-cli, then askfaro auth login.

▶is_holiday

Check whether a specific date is a public holiday in a country.

Free

Example prompts

  • “Is 2026-07-04 a holiday in the US?”
  • “Is Christmas a public holiday in Germany?”
  • “Is 2026-01-26 a holiday in Australia?”

Parameters

datestringrequired

Date to check, YYYY-MM-DD.

countrystringrequired

ISO 3166-1 alpha-2 country code (e.g. US, GB, DE).

languagestringoptional

Optional language code for the localized holiday name.

subdivisionstringoptional

Optional ISO 3166-2 subdivision code (e.g. CA, NSW).

API Usage

curl -X POST "https://skill.askfaro.com/skills/holidays/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Is 2026-07-04 a holiday in the US?"
  }
}'

CLI Usage

askfaro describe holidays/holidays.is_holiday

Install pip install askfaro-cli, then askfaro auth login.

▶countries

List the supported countries and their available subdivisions.

Free

Example prompts

  • “Which countries have holiday data?”
  • “List supported countries for public holidays”
  • “Is Brazil covered?”

API Usage

curl -X POST "https://skill.askfaro.com/skills/holidays/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Which countries have holiday data?"
  }
}'

CLI Usage

askfaro describe holidays/holidays.countries

Install pip install askfaro-cli, then askfaro auth login.

▶next

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

Free

Example prompts

  • “When is the next public holiday in France?”
  • “What are the next 3 holidays in the US?”
  • “Next bank holiday in the UK”

Parameters

countintegeroptional

How many upcoming holidays to return. Defaults to 5.

countrystringrequired

ISO 3166-1 alpha-2 country code (e.g. US, FR, GB).

languagestringoptional

Optional language code for localized holiday names.

from_datestringoptional

Look ahead from this date, YYYY-MM-DD. Defaults to today.

subdivisionstringoptional

Optional ISO 3166-2 subdivision code (e.g. CA, NSW).

API Usage

curl -X POST "https://skill.askfaro.com/skills/holidays/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "When is the next public holiday in France?"
  }
}'

CLI Usage

askfaro describe holidays/holidays.next

Install pip install askfaro-cli, then askfaro auth login.