{"uid":"cap_9sIjcO6c1SEHj_0GzKjRZ","slug":"certaindata-public-holidays-api-addaa788","name":"CertainData Public Holidays API","description":"Dated public-holiday list for a country and year.","url":"https://api.certaindata.ai/ca054d66abad4d6ea80ba43013b61743-cd/holidays/:iso2/:year","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["iso2","year"],"properties":{"iso2":{"type":"string","description":"Country ISO-2 code, e.g. GB."},"year":{"type":"string","description":"Four-digit year, e.g. 2026."}}},"queryParams":{"type":"object","properties":{"type":{"type":"string","description":"Optional. Filter by holiday type, e.g. public or bank. Omit for all."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3NhHp6bTat8b-UoWtCNbk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a dated list of public holidays for a given country (ISO-2 code) and year, optionally filtered by holiday type.","exampleAgentPrompt":"Can you pull the full list of public holidays for Germany in 2026, including both public and bank holidays?","exampleUseCases":null,"resultDescription":"A dated list of public holidays for the specified country and year, each entry including the holiday name, date, and type (e.g. public or bank). The response covers all official holidays unless filtered by type via the optional query parameter.","failureModes":["Invalid ISO-2 country code returns an error or empty result","Unsupported country returns no holiday data","Year out of supported range returns an error or empty list","Invalid holiday type filter returns no results","Malformed path parameters (e.g. non-numeric year) return a 400-level error"],"whenToPreferThis":"Use this endpoint when you need an authoritative, structured list of public or bank holidays for a specific country and year. Prefer it over scraping or general-purpose web search when you need clean, machine-readable holiday data for scheduling, compliance, or calendar enrichment tasks. Ideal for building business logic that avoids scheduling on public holidays across multiple countries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:25.007Z","isFirstParty":false}