{"uid":"cap_TzOk5YTjDNwkNyyyTllm9","slug":"agent-time-place-public-holidays-lookup-426d23ff","name":"Agent Time & Place – Public Holidays Lookup","description":"Geocoding, timezones, holidays, business days, sun times, FX and distances for AI agents. Deterministic, sub-cent, no API key: payment is authentication (x402).","url":"https://time-place.agent-utils.workers.dev/v1/holidays","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":{"year":{"type":"integer","maximum":2100,"minimum":1975},"region":{"type":"string","description":"Optional ISO 3166-2 code (e.g. 'DE-BY') to include that region's holidays"},"country":{"type":"string","description":"ISO 3166-1 alpha-2"},"upcoming":{"type":"boolean","description":"If true, only holidays from today onward"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"year":{"type":"integer"},"count":{"type":"integer"},"country":{"type":"string"},"holidays":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"name":{"type":"string","description":"English name"},"types":{"type":"array","items":{"type":"string"}},"regions":{"type":["array","null"],"items":{"type":"string"},"description":"ISO 3166-2 codes when regional"},"localName":{"type":"string"},"nationwide":{"type":"boolean"}}}}}}}}}},"responseSchema":{"type":"json","example":{"year":2026,"count":11,"country":"FR","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public"],"regions":null,"localName":"Jour de l'an","nationwide":true}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NA26hfHV5Vu2c8xbFa7cA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns public holidays for a given country and year, optionally filtered by region or restricted to upcoming dates","exampleAgentPrompt":"What are all the public holidays in France for 2026, and can you include any regional holidays for Alsace using code FR-67?","exampleUseCases":[{"title":"Scheduler avoiding holiday conflicts","prompt":"Can you list all the upcoming public holidays in Germany for the rest of this year so I can make sure we don't schedule any client calls on those dates?"},{"title":"Regional holiday calendar for Bavaria","prompt":"What public holidays apply specifically in Bavaria, Germany — use region code DE-BY — for 2025, including both national and regional ones?"},{"title":"Travel planning around holidays","prompt":"I'm heading to Japan in 2026 — can you pull up all the national public holidays there for that year so I know which days everything might be closed?"}],"resultDescription":"A JSON object with the queried country code, year, total holiday count, and an array of holiday objects each containing the date (ISO 8601), English name, local-language name, array of holiday type strings (e.g. 'Public'), a nationwide boolean, and an optional array of ISO 3166-2 region codes when the holiday is regional rather than national.","failureModes":["Missing required 'country' query parameter returns a 400-level error","Invalid or unsupported ISO 3166-1 alpha-2 country code returns an error or empty result","Year outside the supported range (1975–2100) may return a validation error","Invalid ISO 3166-2 region code may be silently ignored or return an error","Payment not made or invalid x402 payment header returns a 402 Payment Required response","Network timeout on the Cloudflare Worker edge node"],"whenToPreferThis":"Choose this endpoint when you need deterministic, structured public holiday data for a specific country and year without requiring an API key — authentication is handled via x402 micro-payment. It is ideal for AI agents that need to check business days, avoid scheduling on holidays, or enrich calendaring logic, especially when sub-cent per-call pricing matters. Prefer it over general-purpose calendar APIs when you want predictable machine-readable output with regional granularity and no OAuth setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:23.047Z","isFirstParty":false}