{"uid":"cap_9dykP0Z0JKwUdF9A8Jk5p","slug":"x402-data-bazaar-vercel-app-afbe9f4e","name":"Public Holidays by Country and Year","description":"Public holidays for any country and year. Use ISO 3166-1 alpha-2 country codes. e.g. GET /api/holidays/US/2026","url":"https://x402-data-bazaar.vercel.app/api/holidays/US/2026","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"data":{"year":2026,"count":16,"country":"US","holidays":[{"date":"2026-01-01","name":"New Year's Day","global":true},{"date":"2026-01-19","name":"Martin Luther King, Jr. Day","global":true}]},"source":"Nager.Date API","success":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"unknown","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OKSlR6tVVovJvk63eN62a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of public holidays for a given country and year using ISO 3166-1 alpha-2 country codes","exampleAgentPrompt":"What are all the public holidays in the US for 2026? I need the dates and names of each one.","exampleUseCases":[{"title":"Employee time-off planning calendar","prompt":"Build me a calendar showing which days my team should block off for official holidays in Germany, France, and the UK for next year. I need to know the dates and names so we can plan around them."},{"title":"Global payroll processing schedule","prompt":"Pull all the public holidays for 2025 in Canada, Australia, and India so I can figure out when our payroll team will need to process payments around statutory days off."},{"title":"International meeting availability checker","prompt":"Check what national holidays are coming up in Japan, Brazil, and Mexico this year. I need to avoid scheduling client calls on days when half the team is off."}],"resultDescription":"Returns a JSON object with the year, country code, total holiday count, and an array of holiday objects each containing the date (ISO 8601), holiday name, and a boolean indicating whether it is a globally observed holiday. Sourced from the Nager.Date API.","failureModes":["Invalid or unsupported country code returns an empty holidays array or error","Year out of supported range may return no data","Malformed country code (e.g. 3-letter code instead of 2-letter) causes a 400 or empty response","Network or upstream Nager.Date API unavailability causes a 500 error"],"whenToPreferThis":"Use this endpoint when you need a structured, machine-readable list of public holidays for any country and year, especially for scheduling, workforce planning, calendar apps, or date-aware automation. Prefer this over scraping Wikipedia or government sites when you need clean JSON output with global-holiday flags.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:37.626Z","isFirstParty":false}