Name: holiday-lookup
Price: 0.002 USDC
Availability: InStock

$ man holiday-lookup

agentutility / locale / holiday-lookup

PRICE / CALL

$0.002

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

holiday-lookup — public holidays / bank holidays / national holidays / federal holidays / holiday calendar / per-country dates

SYNOPSIS

POST https://x402.org/v1/holiday-lookup
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Public holidays / bank holidays / national holidays / federal holidays / holiday calendar / per-country dates. Returns the official public holidays for any ISO 3166-1 alpha-2 country and year, with localized names, English names, type (Public, Bank, School, etc.), regional vs. national flag, and county/region scoping where applicable. Wraps the public Nager.Date API — no auth, commercial-OK.

INPUT — request schema

property	type	description	req?
country	string	ISO 3166-1 alpha-2 country code (e.g. 'US', 'DE', 'JP').	required
year	number	Calendar year (e.g. 2026). Range [1900, 2200].	required

OUTPUT — response shape

field	type	description
country	string	ISO 3166-1 alpha-2 country code echoed back from the request (e.g. US, GB, DE, JP).
year	string	Calendar year the holiday list covers, echoed back from the request as a 4-digit string.
holidays	string	Array of holiday objects with date, local name, English name, type, and county/region scoping.
source	string	Upstream data provider attribution, set to Nager.Date for the wrapped public holiday API.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/holiday-lookup \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the holiday-lookup tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: holidayspublic-holidayscalendarlocalecountry-holidaysbank-holidaysnager-date
methods: POST
cluster: locale
price: $0.002 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
astro-times	sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times.	$0.002
country-info	Country info / ISO 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver.	$0.002
earthquakes-recent	Earthquake feed / seismic activity / USGS / recent quakes / quake monitor / tremor data / fault line activity / tsunami alerts.	$0.002
sunrise-sunset	Sunrise sunset times.	$0.002
timezone-convert	Timezone convert / IANA tz conversion / DST-aware time arithmetic / wall-clock to UTC / convert across cities.	$0.001
timezone-lookup	Timezone lookup / IANA tz / UTC offset / DST status / local time at lat-lng / which timezone.	$0.001
iata-airport-info	IATA / ICAO airport code lookup.	$0.005
satellite-tile	Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery.	$0.005

/holiday-lookup(1)