{"uid":"cap_hmB2TpY6uve4tUuDZgW6Y","slug":"api-strale-io-7a9710e4","name":"Public Holiday Lookup by Country and Year","description":"Get public holidays for any country and year. Uses Nager.Date API. Returns holiday dates, names, and next upcoming.","url":"https://api.strale.io/x402/public-holiday-lookup","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_code"],"properties":{"year":{"type":"number"},"country_code":{"type":"string"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"year":2025,"country_code":"US"}}},"response":{"year":2025,"_meta":{"payment":{"method":"x402","price_usd":0.0324,"settlement_id":"0xc34b300f368be42988788cbc63cb6d1a1071e3c2e49f8277efd7885da0aeaa7a"},"capability":"public-holiday-lookup","latency_ms":34,"provenance":{"source":"date.nager.at","fetched_at":"2026-06-16T01:24:44.805Z"}},"holidays":[{"date":"2025-01-01","name":"New Year's Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"New Year's Day"},{"date":"2025-01-20","name":"Martin Luther King, Jr. Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Martin Luther King, Jr. Day"},{"date":"2025-02-12","name":"Lincoln's Birthday","type":"Observance","fixed":false,"global":false,"local_name":"Lincoln's Birthday"},{"date":"2025-02-17","name":"Presidents Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Washington's Birthday"},{"date":"2025-04-18","name":"Good Friday","type":"Public","fixed":false,"global":false,"local_name":"Good Friday"},{"date":"2025-04-18","name":"Good Friday","type":"Optional","fixed":false,"global":false,"local_name":"Good Friday"},{"date":"2025-05-08","name":"Truman Day","type":"School, Authorities","fixed":false,"global":false,"local_name":"Truman Day"},{"date":"2025-05-26","name":"Memorial Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Memorial Day"},{"date":"2025-06-19","name":"Juneteenth National Independence Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Juneteenth National Independence Day"},{"date":"2025-07-04","name":"Independence Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Independence Day"},{"date":"2025-09-01","name":"Labour Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Labor Day"},{"date":"2025-10-13","name":"Columbus Day","type":"Public","fixed":false,"global":false,"local_name":"Columbus Day"},{"date":"2025-10-13","name":"Columbus Day","type":"Bank","fixed":false,"global":true,"local_name":"Columbus Day"},{"date":"2025-10-13","name":"Indigenous Peoples' Day","type":"Public","fixed":false,"global":false,"local_name":"Indigenous Peoples' Day"},{"date":"2025-11-11","name":"Veterans Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Veterans Day"},{"date":"2025-11-27","name":"Thanksgiving Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Thanksgiving Day"},{"date":"2025-12-25","name":"Christmas Day","type":"Public, Bank","fixed":false,"global":true,"local_name":"Christmas Day"}],"country_code":"US","next_upcoming":null,"total_holidays":17}},"exampleRequest":{"year":2025,"country_code":"US"},"tags":["x402"],"displayCostAmount":"0.0324","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.0324/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0324","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0324","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vLqhHQllvTFbrAffdaMxQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0324","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 optional year, including holiday dates, names, and the next upcoming holiday.","exampleAgentPrompt":"What are all the public holidays in Germany for 2025? I need the full list with dates and names.","exampleUseCases":null,"resultDescription":"Returns a list of public holidays for the specified country and year, including each holiday's date, official name, and information about the next upcoming holiday.","failureModes":["Invalid or unsupported country code returns an error or empty result","Year out of supported range may return no data","Missing required country_code parameter causes request failure","Network timeout or upstream Nager.Date API unavailability"],"whenToPreferThis":"Use this endpoint when you need official public holiday data for a specific country and year, especially for scheduling, calendar planning, or compliance checks. Prefer this over general web search when structured, machine-readable holiday data is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:40:46.228Z","isFirstParty":false}