# 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-13). Returns official public holidays for 150+ countries and their regions for a given year, checks whether a specific date is a holiday, and identifies the next upcoming holiday. ## Facts - Endpoint: POST https://api.vextorium.com/festivos-pais-pago?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-13 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/vextorium-public-holidays-api-07b83a77 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NPjvx5M9AvofKJn8CNehT 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-07b83a77 -d '' ``` Example prompt: Can you list all the official public holidays in Spain for the Madrid region in 2026, and let me know which one is coming up next? ## When to prefer this Choose this endpoint when you need official, government-recognized public holidays for a specific country or subnational region (US states, Spanish autonomous communities, German Länder, etc.), especially when you need to check a specific date or find the next upcoming holiday. It covers 150+ countries and uses the authoritative python-holidays library, making it more comprehensive than generic calendar APIs. ## Known failure modes - Missing required 'pais' field returns validation error - Invalid or unsupported ISO country code returns empty or error response - Region code not available for the requested country returns error or list of valid regions - Malformed date format for 'fecha' field causes parsing error - Unsupported year range may return empty holiday list ## How this service works Official public holidays of 150+ countries and their regions (Spanish autonomous communities, US states, German Länder...) for a year, whether a given date is a holiday, and the next holiday. ## Output Returns a JSON object containing the country code, year, optional region code, total number of holidays, a list of holidays each with date, name, and day of week, the next upcoming holiday with its name, date, and days until it occurs, and a list of available region codes for the country. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method", "bodyType", "body" ], "properties": { "body": { "required": [ "pais" ], "properties": { "anio": { "type": "integer" }, "pais": { "type": "string", "description": "ISO 2-letter code" }, "fecha": { "type": "string", "description": "Check this date YYYY-MM-DD (optional)" }, "region": { "type": "string", "description": "Subdivision code, e.g. MD, CT, CA (optional)" } } }, "type": { "type": "string", "const": "http" }, "method": { "enum": [ "POST" ], "type": "string" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": [ "object", "null" ], "properties": { "anio": { "type": [ "number", "null" ] }, "pais": { "type": [ "string", "null" ] }, "total": { "type": [ "number", "null" ] }, "fuente": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "proximo": { "type": [ "object", "null" ], "properties": { "dias": { "type": [ "number", "null" ] }, "fecha": { "type": [ "string", "null" ] }, "nombre": { "type": [ "string", "null" ] } } }, "festivos": { "type": [ "array", "null" ], "items": { "type": [ "null", "object" ], "properties": { "fecha": { "type": [ "null", "string" ] }, "nombre": { "type": [ "null", "string" ] }, "dia_semana": { … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "anio": 2026, "pais": "ES", "total": 12, "fuente": "Librería abierta python-holidays (festivos oficiales nacionales y regionales)", "region": "MD", "proximo": { "dias": 10, "fecha": "2026-10-12", "nombre": "National Day" }, "festivos": [ { "fecha": "2026-01-01", "nombre": "New Year's Day", "dia_semana": "Thursday" }, { "fecha": "2026-01-06", "nombre": "Epiphany", "dia_semana": "Tuesday" }, { "fecha": "2026-04-02", "nombre": "Maundy Thursday", "dia_semana": "Thursday" }, { "fecha": "2026-04-03", "nombre": "Good Friday", "dia_semana": "Friday" }, { "fecha": "2026-05-01", "nombre": "Labor Day", "dia_semana": "Friday" }, { "fecha": "2026-05-02", "nombre": "Madrid Day", "dia_semana": "Saturday" }, { "fecha": "2026-08-15", "nombre": "Assumption Day", "dia_semana": "Saturday" }, { "fecha": "2026-10-12", "nombre": "National Day", "dia_semana": "Monday" }, { "fecha": "2026-11-02", "nombre": "Monday following All Saints' Day", "dia_semana": "Monday" }, { "fecha": "2026-12-07", "nombre": "Monday following Constitution Day", "dia_semana": "Monday" }, { "fecha": "2026-12-08", "nombre": "Immaculate Conception", "dia_semana": "Tuesday" }, { "fecha": "2026-12-25", "nombre": "Christmas Day", "dia_semana": "Friday" } ], "regiones_disponibles": [ "AN", "AR", "AS", "CB", "CE", "CL", "CM", "CN", "CT", "EX", "GA", "IB", "MC", "MD", "ML", "NC", "PV", "RI", "VC" ] } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-public-holidays-api-07b83a77/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)