# Suverse Next Public Holidays

> Suverse Next Public Holidays 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-13).

Returns upcoming public holidays for a given country over the next year, including each holiday's date and name, sourced from Nager.Date with no API key required.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-next-holidays
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-next-public-holidays-a524ad11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D8prQr9_3hlpEdgkbjKbo

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-next-public-holidays-a524ad11 -d '<json body>'
```

Example prompt: What are all the upcoming public holidays in France over the next year so I can plan around any closures?

## When to prefer this

Choose this endpoint when you need a quick, no-auth lookup of upcoming public holidays for a specific country, especially in agent workflows that involve scheduling, reminders, or planning around office closures. It is ideal when you don't want to manage your own Nager.Date integration or API key.

## Known failure modes

- Unsupported or unrecognized country code returns an empty list or error
- Nager.Date upstream outage causes degraded or failed response
- Malformed request body results in a 400 error
- Payment failure via x402 protocol blocks the call before it reaches the data provider

## How this service works

Upcoming public holidays for a country in the next year from Nager.Date, no key. Returns each holiday date and name. For AI agents reminding users and planning around upcoming closures.

## Output

A list of upcoming public holidays for the requested country over the next year, each entry containing the holiday's date (in ISO format) and its official name.

## 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-next-public-holidays-a524ad11/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)