{"uid":"cap_wJOdv710vyZNCpwFHoOd6","slug":"foundry-public-holidays-cfd6135e","name":"Foundry Public Holidays","description":"Public holidays for a country and year, with the next upcoming one. Input: country code and year, e.g. 'US 2026'.","url":"https://minty-sprout.onrender.com/v1/public-holidays?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","maxLength":8000,"description":"2-letter country code and optional year"}}},"responseSchema":{"type":"json","example":{"next":{"date":"2026-11-11","name":"Veterans Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Veterans Day","launchYear":null,"countryCode":"US"},"year":2026,"count":17,"country":"US","holidays":[{"date":"2026-01-01","name":"New Year's Day","global":true,"local_name":"New Year's Day"},{"date":"2026-01-19","name":"Martin Luther King, Jr. Day","global":true,"local_name":"Martin Luther King, Jr. Day"},{"date":"2026-02-12","name":"Lincoln's Birthday","global":false,"local_name":"Lincoln's Birthday"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.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_FJAKUxIqf9Iv_DHQAOvjZ","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 a list of public holidays for a given country and year, plus the next upcoming holiday from today.","exampleAgentPrompt":"What are all the public holidays in the US for 2026, and which one is coming up next?","exampleUseCases":[{"title":"Travel itinerary holiday awareness","prompt":"I'm planning a trip to Japan in 2025 — can you pull up all the public holidays there so I know which days might be busy or have closures?"},{"title":"Payroll scheduling around bank holidays","prompt":"What are all the UK public holidays in 2026? I need to make sure our payroll doesn't land on a bank holiday."},{"title":"Next public holiday countdown","prompt":"What's the next public holiday coming up in Canada? I want to know how many days away it is."}],"resultDescription":"A JSON object containing the two-letter country code, year, total count of holidays, a full list of holidays (each with date, name, local name, global flag), and a 'next' field identifying the next upcoming holiday from today with its date, name, type, and metadata.","failureModes":["Invalid or unsupported country code returns an error or empty list","Year far in the future may have incomplete or estimated holiday data","Missing input parameters may cause a 400-level error","Network timeout from hosted Render.com instance during cold start","Payment failure returns 402 before any data is returned"],"whenToPreferThis":"Use this endpoint when you need a structured, machine-readable list of official public holidays for a specific country and year, especially when you also need to know which holiday is coming up next. Prefer this over calendar APIs when the use case is international holiday lookup rather than personal event management, and when a lightweight pay-per-call model is preferable to a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:56:33.478Z","isFirstParty":false,"canonicalSlug":"foundry-public-holidays-cfd6135e"}