{"uid":"cap_OQvHeNYll3Xccaz8qw65y","slug":"suverse-long-weekends-api-c6a6b7df","name":"Suverse Long Weekends API","description":"Long weekends for a country and year from Nager.Date, no key. Returns each long weekend start date, end date, and day count. For AI agents in travel, retail, and staffing planning.","url":"https://proxy.suverse.io/v1/data/suverse-long-weekends","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":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"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.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A33oL2PXPwlq3IquWyi8E","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns long weekends (start date, end date, and day count) for a given country and year using Nager.Date data, with no API key required.","exampleAgentPrompt":"What are all the long weekends in Canada for 2025? I want the start date, end date, and how many days each one lasts.","exampleUseCases":[{"title":"Travel trip planning around long weekends","prompt":"Can you show me all the long weekends in France for 2025? I want to know the start and end dates and how many days each long weekend is, so I can plan some short trips."},{"title":"Retail promotion scheduling","prompt":"List all the long weekends in the United States for 2024 — I need the start and end dates and day counts so I can schedule our sale campaigns around them."},{"title":"Workforce staffing coverage planning","prompt":"What are all the long weekends in Australia this year? I need to know when they start, when they end, and how many days they span so I can plan staffing coverage."}],"resultDescription":"A list of long weekend periods for the specified country and year, where each entry includes the start date, end date, and the total number of days in the long weekend. Data is sourced from Nager.Date's public holiday calendar.","failureModes":["Unsupported country code returns empty list or error","Invalid year format causes request failure","Country not covered by Nager.Date returns no results","Network timeout from upstream Nager.Date API","Malformed POST body returns validation error"],"whenToPreferThis":"Use this endpoint when you need structured, date-ranged long weekend data (not just individual public holidays) for a specific country and year, particularly for travel scheduling, retail campaign planning, or workforce management. It is keyless and low-cost, making it ideal for automated agent workflows that need calendar enrichment without requiring a dedicated holiday API subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:54:35.977Z","isFirstParty":false}