{"uid":"cap_bwU6_VtRwW2OLnMjJwZcA","slug":"api-auor-io-f64d37e4","name":"Open Holidays Public Holiday Lookup","description":"Public holiday information","url":"https://api.auor.io/open-holidays/v1/public","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":{"$ref":"https://api.auor.io/schemas/open-holidays/v1/public/input.json","type":"object","$schema":"https://json-schema.org/draft/2020-12/schema"}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"year":2025,"country":"DE"}}},"response":[{"id":"27f0d8cd-76b2-47e7-89ac-a3a9f6a6b1ba","name":[{"text":"New Year's Day","language":"EN"}],"type":"Public","endDate":"2025-01-01","startDate":"2025-01-01","nationwide":true,"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"1c80b87d-8221-4dc2-9a1a-3b0f57dce9f5","name":[{"text":"Epiphany","language":"EN"}],"type":"Public","endDate":"2025-01-06","startDate":"2025-01-06","nationwide":false,"subdivisions":[{"code":"DE-ST","shortName":"ST"},{"code":"DE-BW","shortName":"BW"},{"code":"DE-BY","shortName":"BY"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"4522bbfa-eaee-4efe-b13c-dac7f67bb986","name":[{"text":"International Women's Day","language":"EN"}],"type":"Public","endDate":"2025-03-08","startDate":"2025-03-08","nationwide":false,"subdivisions":[{"code":"DE-BE","shortName":"BE"},{"code":"DE-MV","shortName":"MV"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"c7aef0d5-f292-4d08-b878-a25a6c05fc12","name":[{"text":"Good Friday","language":"EN"}],"type":"Public","endDate":"2025-04-18","startDate":"2025-04-18","nationwide":true,"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"90718fa1-5b71-49dc-90a4-142a8aef72d8","name":[{"text":"Easter Sunday","language":"EN"}],"type":"Public","endDate":"2025-04-20","startDate":"2025-04-20","nationwide":false,"subdivisions":[{"code":"DE-BB","shortName":"BB"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"12776265-e638-4112-a11f-f24bb37d8a3d","name":[{"text":"Easter Monday","language":"EN"}],"type":"Public","endDate":"2025-04-21","startDate":"2025-04-21","nationwide":true,"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"5db64014-1aaf-46f0-be83-d8baa826cfef","name":[{"text":"Labour Day","language":"EN"}],"type":"Public","endDate":"2025-05-01","startDate":"2025-05-01","nationwide":true,"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"4905efd7-e75e-4930-80b8-d35ca157e5bf","name":[{"text":"Liberation Day","language":"EN"}],"tags":["OneTime"],"type":"Public","endDate":"2025-05-08","startDate":"2025-05-08","nationwide":false,"subdivisions":[{"code":"DE-BE","shortName":"BE"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"9fbbb949-8b22-4916-a16c-0a799a2dd79f","name":[{"text":"Ascension Day","language":"EN"}],"type":"Public","endDate":"2025-05-29","startDate":"2025-05-29","nationwide":true,"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"edfb560a-d5c6-493f-b1c1-06f2936347e7","name":[{"text":"Pentecost Sunday","language":"EN"}],"type":"Public","endDate":"2025-06-08","startDate":"2025-06-08","nationwide":false,"subdivisions":[{"code":"DE-BB","shortName":"BB"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"b52574c0-0e5d-44ff-ac6b-4e3c6d71f1d7","name":[{"text":"Pentecost Monday","language":"EN"}],"type":"Public","endDate":"2025-06-09","startDate":"2025-06-09","nationwide":true,"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"2590b1ad-4268-4cac-a11a-5192791d0c0d","name":[{"text":"Corpus Christi","language":"EN"}],"type":"Public","endDate":"2025-06-19","startDate":"2025-06-19","nationwide":false,"subdivisions":[{"code":"DE-HE","shortName":"HE"},{"code":"DE-SL","shortName":"SL"},{"code":"DE-NW","shortName":"NW"},{"code":"DE-BW","shortName":"BW"},{"code":"DE-RP","shortName":"RP"},{"code":"DE-BY","shortName":"BY"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"dc74ad4c-cea7-426a-bef2-ce38fa3435ef","name":[{"text":"High Festival of Peace","language":"EN"}],"type":"Public","endDate":"2025-08-08","startDate":"2025-08-08","nationwide":false,"subdivisions":[{"code":"DE-BY-AU","shortName":"BY-AU"}],"regionalScope":"Local","temporalScope":"FullDay"},{"id":"e09a9106-86e9-4eeb-9c84-5d257b4f9488","name":[{"text":"Assumption Day","language":"EN"}],"type":"Public","endDate":"2025-08-15","startDate":"2025-08-15","nationwide":false,"subdivisions":[{"code":"DE-SL","shortName":"SL"},{"code":"DE-BY","shortName":"BY"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"7d63faa9-5577-4527-a192-edf54e28cd1a","name":[{"text":"World Children's Day","language":"EN"}],"type":"Public","endDate":"2025-09-20","startDate":"2025-09-20","nationwide":false,"subdivisions":[{"code":"DE-TH","shortName":"TH"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"ac964e18-2d34-497a-a9c5-b8ab065b7238","name":[{"text":"Day of German Unity","language":"EN"}],"type":"Public","endDate":"2025-10-03","startDate":"2025-10-03","nationwide":true,"regionalScope":"National","temporalScope":"FullDay"},{"id":"2514f889-8ff3-460c-b12c-c886f8b653de","name":[{"text":"Reformation Day","language":"EN"}],"type":"Public","endDate":"2025-10-31","startDate":"2025-10-31","nationwide":false,"subdivisions":[{"code":"DE-SH","shortName":"SH"},{"code":"DE-ST","shortName":"ST"},{"code":"DE-HH","shortName":"HH"},{"code":"DE-HB","shortName":"HB"},{"code":"DE-TH","shortName":"TH"},{"code":"DE-MV","shortName":"MV"},{"code":"DE-SN","shortName":"SN"},{"code":"DE-NI","shortName":"NI"},{"code":"DE-BB","shortName":"BB"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"0e5ed383-7890-4f12-b041-65a79aedeb5f","name":[{"text":"All Saints' Day","language":"EN"}],"type":"Public","endDate":"2025-11-01","startDate":"2025-11-01","nationwide":false,"subdivisions":[{"code":"DE-SL","shortName":"SL"},{"code":"DE-NW","shortName":"NW"},{"code":"DE-BW","shortName":"BW"},{"code":"DE-RP","shortName":"RP"},{"code":"DE-BY","shortName":"BY"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"1d68ac36-9690-4b06-b62d-de890d5b50ef","name":[{"text":"Repentance Day","language":"EN"}],"type":"Public","endDate":"2025-11-19","startDate":"2025-11-19","nationwide":false,"subdivisions":[{"code":"DE-SN","shortName":"SN"}],"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"92b270e3-247f-4f82-b79d-b5ad77a67d95","name":[{"text":"Christmas Day","language":"EN"}],"type":"Public","endDate":"2025-12-25","startDate":"2025-12-25","nationwide":true,"regionalScope":"Regional","temporalScope":"FullDay"},{"id":"28bf580c-9787-4d67-ab3e-06a5e6597c1c","name":[{"text":"2nd Day of Christmas","language":"EN"}],"type":"Public","endDate":"2025-12-26","startDate":"2025-12-26","nationwide":true,"regionalScope":"Regional","temporalScope":"FullDay"}]},"exampleRequest":{"year":2025,"country":"DE"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_722SM-Oq1YVygtKEcWiXv","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 public holiday information for a given country or region via a GET request","exampleAgentPrompt":"What are all the public holidays in Germany for 2025? I need the full list with dates and holiday names.","exampleUseCases":null,"resultDescription":"A list of public holidays for the requested country or region, including holiday names, dates, and possibly holiday types (national, regional, etc.).","failureModes":["Unsupported or invalid country code returns an error or empty result","Missing required query parameters results in a 400 Bad Request","Payment not attached results in a 402 Payment Required response","Year out of supported range returns an error or empty list","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need authoritative public holiday data for a specific country or region, especially in automated scheduling, calendar generation, or workflow automation contexts where knowing official holidays matters. Prefer this over manual lookups or scraped data when you need structured, machine-readable holiday lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:01.836Z","isFirstParty":false}