{"uid":"cap_DV-S2w2CKtYOp-xXu-zmm","slug":"vibesprings-net-16bae0f8","name":"Vibesprings Holiday Calendar API","description":"Comprehensive public and bank holiday calendar reference database. Covers over 100 countries globally. Returns official national holiday dates, local/native names, public bank holiday indicators, and regional holiday scopes. Essential for workforce scheduling, school calendar imports, international banking clearing day calculations, and e-commerce shipping timeline planning.","url":"https://vibesprings.net/api/holidays","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"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"year":{"type":"number","description":"4-digit calendar year to query (e.g. 2025)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g. US, GB, DE, FR, JP)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2025,"country":"US","holidays":[{"date":"2025-01-01","name":"New Year's Day","fixed":true,"types":["Public"],"global":true,"localName":"New Year's Day"}],"total_holidays":11}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"year":2025,"country":"US"}}},"response":{"year":2025,"country":"US","holidays":[{"date":"2025-01-01","name":"New Year's Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"New Year's Day","countryCode":"US"},{"date":"2025-01-20","name":"Martin Luther King, Jr. Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Martin Luther King, Jr. Day","countryCode":"US"},{"date":"2025-02-12","name":"Lincoln's Birthday","fixed":false,"types":["Observance"],"global":false,"counties":["US-CA","US-CT","US-IL","US-IN","US-KY","US-MI","US-NY","US-MO","US-OH"],"localName":"Lincoln's Birthday","countryCode":"US"},{"date":"2025-02-17","name":"Presidents Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Washington's Birthday","countryCode":"US"},{"date":"2025-04-18","name":"Good Friday","fixed":false,"types":["Public"],"global":false,"counties":["US-CT","US-DE","US-HI","US-IN","US-KY","US-LA","US-NC","US-ND","US-NJ","US-TN"],"localName":"Good Friday","countryCode":"US"},{"date":"2025-04-18","name":"Good Friday","fixed":false,"types":["Optional"],"global":false,"counties":["US-TX"],"localName":"Good Friday","countryCode":"US"},{"date":"2025-05-08","name":"Truman Day","fixed":false,"types":["School","Authorities"],"global":false,"counties":["US-MO"],"localName":"Truman Day","countryCode":"US"},{"date":"2025-05-26","name":"Memorial Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Memorial Day","countryCode":"US"},{"date":"2025-06-19","name":"Juneteenth National Independence Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Juneteenth National Independence Day","countryCode":"US"},{"date":"2025-07-04","name":"Independence Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Independence Day","countryCode":"US"},{"date":"2025-09-01","name":"Labour Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Labor Day","countryCode":"US"},{"date":"2025-10-13","name":"Columbus Day","fixed":false,"types":["Public"],"global":false,"counties":["US-AL","US-AZ","US-CO","US-CT","US-GA","US-ID","US-IL","US-IN","US-IA","US-KS","US-KY","US-LA","US-ME","US-MD","US-MA","US-MS","US-MO","US-MT","US-NE","US-NH","US-NJ","US-NM","US-NY","US-NC","US-OH","US-OK","US-PA","US-RI","US-SC","US-TN","US-UT","US-VA","US-WV"],"localName":"Columbus Day","countryCode":"US"},{"date":"2025-10-13","name":"Columbus Day","fixed":false,"types":["Bank"],"global":true,"counties":null,"localName":"Columbus Day","countryCode":"US"},{"date":"2025-10-13","name":"Indigenous Peoples' Day","fixed":false,"types":["Public"],"global":false,"counties":["US-AK","US-AL","US-CA","US-HI","US-IA","US-LA","US-ME","US-MI","US-MN","US-NC","US-NE","US-NM","US-OK","US-OR","US-SD","US-TX","US-VA","US-VT","US-WI"],"localName":"Indigenous Peoples' Day","countryCode":"US"},{"date":"2025-11-11","name":"Veterans Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Veterans Day","countryCode":"US"},{"date":"2025-11-27","name":"Thanksgiving Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Thanksgiving Day","countryCode":"US"},{"date":"2025-12-25","name":"Christmas Day","fixed":false,"types":["Public","Bank"],"global":true,"counties":null,"localName":"Christmas Day","countryCode":"US"}],"processingTime":"136ms","total_holidays":17}},"exampleRequest":{"year":2025,"country":"US"},"tags":["x402"],"displayCostAmount":"0.002","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.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_cFVW0wnhG0gvI8rerwUKY","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 official public and bank holiday dates for a given country and year, including local names, holiday types, and regional scopes","exampleAgentPrompt":"Can you get me all the official public and bank holidays for Germany in 2025, including their local names and whether each one is a national or regional holiday?","exampleUseCases":[{"title":"International shipping timeline validation","prompt":"We're planning to ship orders across Europe next quarter. Can you pull all the public and bank holidays for France, Germany, and Spain in 2025 so we can identify which days our fulfillment centers and banks will be closed?"},{"title":"Global workforce scheduling automation","prompt":"I need to build out our team's work calendar for 2025 across our offices in Tokyo, London, and Sydney. Can you get me the official public holidays and bank holidays for Japan, the UK, and Australia so I can block out non-working days for scheduling?"},{"title":"Annual HR compliance calendar","prompt":"We're putting together our HR handbook for next year and need to document all statutory holidays our employees should expect. Can you give me the complete list of official public and bank holidays for Canada in 2025, including the local names and whether each one applies nationally or just in certain provinces?"}],"resultDescription":"A list of official public and bank holidays for the requested country and year, including each holiday's date, English name, local/native name, bank holiday status indicator, and regional scope (national vs. sub-regional).","failureModes":["Missing required 'country' query parameter returns a 400 error","Invalid or unsupported country code returns an empty list or 404","Year outside supported range returns an error or empty response","Payment failure via x402 protocol returns a 402 Payment Required response","Network timeout or server error returns a 500 response"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured public holiday data for over 100 countries — especially for workforce scheduling, banking clearance day calculations, international shipping timeline planning, or importing holidays into calendars. Prefer this over manual scraping or general-purpose search when you need machine-readable, reliably structured output with local native names and bank holiday indicators.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:56.538Z","isFirstParty":false}