{"uid":"cap_3YztrRd7pYRoucIAP967e","slug":"orbit-geo-time-public-holidays-by-country-a48ee791","name":"Orbit Geo & Time: Public Holidays by Country","description":"Location and time data for agents: weather now + 7-day forecast (MET Norway), geocoding and reverse geocoding (OpenStreetMap Nominatim), sunrise/sunset, world time-zone conversion and public holidays (Nager.Date). Real open data fetched at call time, attribution included. $0.001 per call. By orbit-builder.","url":"https://orbit-geo.orbit-builder.workers.dev/v1/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"date":{"type":"string","description":"optional YYYY-MM-DD to test"},"year":{"type":"integer","description":"default current year"},"country":{"type":"string","description":"ISO 3166-1 alpha-2, e.g. US, DE, KZ"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"next":[{"date":"2026-10-25","name":"Republic Day"}],"year":2026,"count":15,"country":"KZ","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public"],"global":true,"local_name":"Жаңа жыл"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WRBm9srro06WiokFMjrIc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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 a given country and year, including date, local/English name, nationwide vs regional scope, and holiday type","exampleAgentPrompt":"What are all the official public holidays in Germany for 2025? I need each holiday's date, English and German name, whether it's nationwide or regional, and what type it is (Public, Bank, School, etc.).","exampleUseCases":[{"title":"HR payroll calendar planning","prompt":"Can you pull all the official public holidays for the United States in 2025? I need the date, English name, and whether each one is nationwide or just regional so I can set up our payroll calendar."},{"title":"Checking if a date is a holiday","prompt":"Is November 1st, 2025 a public holiday in France? If so, what's it called and what type of holiday is it?"},{"title":"Finding next upcoming holidays","prompt":"What are the next public holidays coming up in Japan starting from today? Just list the soonest ones with their dates and names."}],"resultDescription":"A JSON object containing the country code, year, total holiday count, a full list of holidays (each with date, English name, local name, type array, and global/regional flag), and a 'next' array showing the nearest upcoming holidays from today's date.","failureModes":["Unsupported or invalid country code returns HTTP 404 (not billed)","Missing country parameter causes the API to run with example input instead","Invalid year format may produce unexpected results","Very small or unrecognized territories may lack holiday data"],"whenToPreferThis":"Choose this endpoint when you need authoritative, structured public holiday data for 100+ countries including local-language names, holiday classification (Public, Bank, School), and nationwide vs regional scope — especially when you need to check a specific date or find upcoming holidays. It is priced per-call at $0.001 USDC and sits alongside geocoding and weather endpoints in the same orbit-geo service suite, making it convenient when already using that stack.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:43:25.409Z","isFirstParty":false,"canonicalSlug":"orbit-geo-time-public-holidays-by-country-a48ee791"}