# Suverse Long Weekends API

> Suverse Long Weekends API is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-long-weekends
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-long-weekends-api-c6a6b7df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OQvHeNYll3Xccaz8qw65y

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability suverse-long-weekends-api-c6a6b7df -d '<json body>'
```

Example prompt: What are all the long weekends in Canada for 2025? I want the start date, end date, and how many days each one lasts.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-long-weekends-api-c6a6b7df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)