# Vextorium Public Holidays API

> Vextorium Public Holidays API is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-30).

Returns official public holidays for 150+ countries and their regions for a given year, checks if a specific date is a holiday, and identifies the next upcoming holiday.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/public-holidays?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-public-holidays-api-2e0e5b7e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NtS5Bu5EskZSHt12xA1uJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-public-holidays-api-2e0e5b7e -d '<json body>'
```

Example prompt: What are all the official public holidays in Spain (country code ES) for 2026, and when is the next one coming up from today? Also include holidays specific to the Madrid region (MD).

## When to prefer this

Choose this endpoint when you need official, structured public holiday data for a specific country or subnational region (US states, German Länder, Spanish autonomous communities, etc.) for a full year, or when checking whether a specific date is a holiday, or finding the next upcoming holiday. Prefer this over general calendar APIs when you need region-level granularity across 150+ countries at low cost per call.

## Known failure modes

- Missing required 'country' field returns an error
- Invalid or unsupported ISO country code may return empty results or an error
- Unsupported region/subdivision code may return no regional holidays or an error
- Malformed date string (not YYYY-MM-DD) may cause a validation error
- Year out of supported range may return empty or error
- Country with no regional subdivision support will return null for region-specific fields

## How this service works

244 pay-per-call data APIs for AI agents: official statistics and economy (ECB, Fed, Eurostat, World Bank, SEC, BOE, INE), crypto prices and sentiment, Spanish public data, compliance (sanctions, VAT, IBAN, LEI), science, weather, web and developer tools and local AI text tools. Pay in USDC via x402.

## Output

A JSON object containing: the country and region queried, the year, a full list of holidays with date, name, and weekday, the total count of holidays, the next upcoming holiday with its name, date, and days away, and a list of available region codes. Data sourced from the python-holidays open-source library.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "description": "Check this date YYYY-MM-DD (optional)"
  },
  "year": {
   "type": "integer"
  },
  "region": {
   "type": "string",
   "description": "Subdivision code, e.g. MD, CT, CA (optional)"
  },
  "country": {
   "type": "string",
   "description": "ISO 2-letter code"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "next": {
   "date": "2026-10-12",
   "days": 10,
   "name": "National Day"
  },
  "year": 2026,
  "total": 12,
  "region": "MD",
  "source": "Open-source python-holidays library (official national and regional holidays)",
  "country": "ES",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "weekday": "Thursday"
   },
   {
    "date": "2026-01-06",
    "name": "Epiphany",
    "weekday": "Tuesday"
   }
  ],
  "available_regions": [
   "AN",
   "AR"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-public-holidays-api-2e0e5b7e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)