{"uid":"cap_NPjvx5M9AvofKJn8CNehT","slug":"vextorium-public-holidays-api-07b83a77","name":"Vextorium Public Holidays API","description":"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.","url":"https://api.vextorium.com/festivos-pais-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":{"type":["null","string"]}}}},"regiones_disponibles":{"type":["array","null"],"items":{"type":["null","string"]}}}}}}}},"responseSchema":{"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"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EtfDlYm2cBtQur-LplrMC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Travel planning around local holidays","prompt":"I'm planning a business trip to Japan in April 2025 — can you pull up all the official public holidays there so I know which days offices will be closed?"},{"title":"HR payroll calendar for German states","prompt":"We need the complete list of public holidays for Bavaria (BY) in Germany for 2025 to set up our payroll calendar — can you get that?"},{"title":"Check if a specific date is a US state holiday","prompt":"Is November 11, 2025 a public holiday in California? I want to know before I schedule a government office visit."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:41:57.531Z","isFirstParty":false,"canonicalSlug":"vextorium-public-holidays-api-07b83a77"}