{"uid":"cap_MFM_UqFXx1i_STa1Xd5PR","slug":"openverbs-holidays-list-803e90b3","name":"OpenVerbs Holidays List","description":"List a country's holidays for a calendar year (optionally by state/region, language and type).","url":"https://holidays.openverbs.com/v1/list","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["country","year"],"properties":{"year":{"type":"integer","maximum":2200,"minimum":1900,"description":"Calendar year."},"state":{"type":"string","description":"Optional state/province code (e.g. \"CA\" for US-California, \"BY\" for DE-Bavaria)."},"types":{"type":"array","items":{"enum":["public","bank","school","optional","observance"],"type":"string"},"description":"Optional filter: only these holiday types. Defaults to all."},"region":{"type":"string","description":"Optional sub-region code, where the country/state defines one."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"ISO 3166-1 alpha-2 country code, e.g. \"US\", \"DE\", \"GB\"."},"language":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional 2-letter language for holiday names (e.g. \"en\")."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4BdMkPjYs7-mxqB7f0kF7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all holidays for a given country and calendar year, with optional filtering by state/region, language, and holiday type.","exampleAgentPrompt":"Can you list all public and bank holidays in Germany for 2025, including any specific to Bavaria, in English?","exampleUseCases":[{"title":"Payroll calendar for global HR team","prompt":"List all public holidays in the US for 2025, filtered to California, so I can mark the non-working days in our payroll calendar."},{"title":"School year planning for parents","prompt":"What are all the school holidays in France for 2025? I need to plan my kids' activities around them."},{"title":"Business hours automation for e-commerce","prompt":"Give me every public and bank holiday in the UK for 2026 so I can configure our store's automated closure schedule."}],"resultDescription":"A structured list of holidays for the specified country and year, each entry including the holiday name (in the requested language), date, type (public, bank, school, optional, observance), and any applicable state or region scope.","failureModes":["Invalid or unsupported country code returns an error or empty list","Year outside 1900–2200 range is rejected by schema validation","Unsupported state or region code may return an error or be silently ignored","Requested language may not be available for all holiday names, falling back to default","Network or payment (x402) failure results in no response"],"whenToPreferThis":"Use this endpoint when you need a comprehensive list of holidays for a country over an entire calendar year, especially when filtering by state, region, type, or language is needed. Prefer this over the sibling 'check date' endpoint when you need to enumerate or display all holidays rather than verify a single date.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:24.222Z","isFirstParty":false}