{"uid":"cap_KcSonHbrIrCtR_0GlIT_K","slug":"eu-regional-holidays-lookup-f4ebd508","name":"EU Regional Holidays Lookup","description":"Public holidays and school holidays with subdivision granularity (German Laender, French academies, Spanish communities...) from the OpenHolidays API (data ODbL-1.0, ~36 mostly European countries). Query: ?country=DE&from=2026-07-01&to=2026-12-31&type=public|school&subdivision=DE-BY (optional ISO 3166-2 filter; window max 366 days, default today +6 months). Each entry: dates, English name, nationwide flag, affected subdivision codes. 24h cache.","url":"https://data.greeneris.io/v1/eu/holidays-regional","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"to":{"type":"string","description":"ISO end date (default: from + 6 months, max +366 days)"},"from":{"type":"string","description":"ISO start date (default: today)"},"type":{"enum":["public","school"],"type":"string","default":"public"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g. DE, FR, AT)"},"subdivision":{"type":"string","description":"ISO 3166-2 subdivision filter, e.g. DE-BY"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"to":"2026-11-05","from":"2026-10-01","count":2,"source":"OpenHolidays API (openholidaysapi.org), data ODbL-1.0, attribution required","country":"DE","holidays":[{"name":"Day of German Unity","type":"Public","end_date":"2026-10-03","nationwide":true,"start_date":"2026-10-03","subdivisions":[]},{"name":"All Saints' Day","type":"Public","end_date":"2026-11-01","nationwide":false,"start_date":"2026-11-01","subdivisions":["DE-SL","DE-NW","DE-BW","DE-RP","DE-BY"]}],"subdivision":null,"holiday_type":"public"}},"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_sLrWUg1LO6zTQLJhhd9Qs","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 official public or school holidays for a given EU/European country and optional subdivision within a specified date range","exampleAgentPrompt":"What public holidays are coming up in Germany, specifically Bavaria (DE-BY), between October 1 and November 5, 2026?","exampleUseCases":null,"resultDescription":"A JSON object containing the queried country, date range, holiday type filter, subdivision filter, a count of matching holidays, and an array of holiday objects each with name, type, start date, end date, nationwide flag, and applicable subdivisions. Also includes the data source attribution string.","failureModes":["Missing required 'country' query parameter returns 400 error","Invalid country code (not ISO 3166-1 alpha-2) may return empty results or error","Date range exceeding 366 days from start is not supported","Invalid subdivision code silently ignored or returns error","Unpaid request returns HTTP 402 with machine-readable payment quote in USDC on Base via x402 protocol","No holidays found in range returns count:0 with empty holidays array (not charged for empty answers)"],"whenToPreferThis":"Use this endpoint when you need official, structured holiday data for European countries — especially when you need subdivision/regional filtering (e.g. German Bundesländer, French regions) or both public and school holiday types. Prefer this over generic calendar APIs when official government-sourced data and EU coverage are required. Ideal for automating business day calculations, scheduling, compliance checks, or calendar enrichment for European operations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:46:33.215Z","isFirstParty":false}