{"uid":"cap_NtS5Bu5EskZSHt12xA1uJ","slug":"vextorium-public-holidays-api-2e0e5b7e","name":"Vextorium Public Holidays API","description":"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.","url":"https://api.vextorium.com/v1/public-holidays?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_TB9AG2ZDRIlclYtmy4iDA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","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 if a specific date is a holiday, and identifies the next upcoming holiday.","exampleAgentPrompt":"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).","exampleUseCases":[{"title":"Payroll calendar for US state employees","prompt":"List all official public holidays in Texas for 2025 — I need to know which days employees won't be working so I can set up our payroll schedule."},{"title":"Checking if a date is a holiday before scheduling","prompt":"Is March 19 a public holiday in Italy in 2025? I'm trying to schedule a business meeting and want to make sure it's not a national holiday."},{"title":"Travel planning around local holidays","prompt":"What public holidays does Japan observe in 2025? I'm planning a trip and want to avoid dates when everything might be closed."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:11:34.676Z","isFirstParty":false,"canonicalSlug":"vextorium-public-holidays-api-07b83a77"}