# Holiday Calendar API – Next Public Holiday

> Holiday Calendar API – Next Public Holiday is a paid API for AI agents from holidays.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the next official public holiday strictly after a given ISO date for a supported country or optional regional subdivision.

## Facts

- Endpoint: GET https://holidays.use.x402atlas.com/next
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/holiday-calendar-api-next-public-holiday-140b388d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Sol_XngjeCARJLZMFf31c

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 holiday-calendar-api-next-public-holiday-140b388d
```

Example prompt: What's the next official public holiday in France (FR) after 2024-07-14 — give me the name and date, and respond in French?

## When to prefer this

Use this endpoint when you need the single next upcoming public holiday after a specific date for a supported European, Latin American, or South African country, optionally scoped to a regional subdivision. It is ideal for scheduling, payroll, travel planning, or reminder automation where you need the immediate next holiday rather than a full year's list. Prefer sibling endpoints for full-year holiday lists, business-day counting, or business-day addition calculations.

## Known failure modes

- Unsupported country code returns a validation error (country not in the supported enum list)
- Invalid or malformed ISO date in 'after' parameter returns a 400-level error
- Subdivision code that does not match the selected country returns an error
- No upcoming holiday found within lookup window may return an empty or null holiday field with an explanatory note
- Network or payment failure returns a non-200 response requiring retry

## How this service works

Next official public holiday after a date for a supported country or regional subdivision.

## Output

Returns a JSON object containing the matched country code, the 'after' date queried, the query timestamp, and a 'holiday' object with the holiday's localized name, start date, end date, type (e.g. public, bank), whether it is nationwide, and any relevant subdivisions. If no holiday is found within a reasonable window, a note field may explain the situation.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country",
      "after"
     ],
     "properties": {
      "after": {
       "type": "string",
       "format": "date",
       "description": "Find the first holiday strictly after this ISO date"
      },
      "country": {
       "enum": [
        "AD",
        "AL",
        "AT",
        "BE",
        "BG",
        "BR",
        "BY",
        "CH",
        "CZ",
        "DE",
        "EE",
        "ES",
        "FR",
        "HR",
        "HU",
        "IE",
        "IT",
        "LI",
        "LT",
        "LU",
        "LV",
        "MC",
        "MD",
        "MT",
        "MX",
        "NL",
        "PL",
        "PT",
        "RO",
        "RS",
        "SE",
        "SI",
        "SK",
        "SM",
        "VA",
        "ZA"
       ],
       "type": "string",
       "description": "Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Z]{2}$",
       "description": "Optional two-letter ISO 639-1 result language. Defaults to English when available."
      },
      "subdivision": {
       "type": "string",
       "pattern": "^[A-Z]{2}-.+$",
       "maxLength": 20,
       "description": "Optional regional subdivision code beginning with the selected country code, for example DE-BE."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "country",
      "after",
      "queried_at"
     ],
     "properti
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "after": "2026-02-01",
  "country": "DE",
  "holiday": {
   "name": "International Women's Day",
   "type": "Public",
   "end_date": "2026-03-08",
   "nationwide": false,
   "start_date": "2026-03-08",
   "subdivisions": [
    "DE-BE"
   ],
   "regional_scope": "Regional",
   "temporal_scope": "FullDay"
  },
  "language": "EN",
  "queried_at": "2026-07-27T12:00:00Z",
  "subdivision": "DE-BE"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/holiday-calendar-api-next-public-holiday-140b388d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holidays.use.x402atlas.com](https://www.zero.xyz/host/holidays.use.x402atlas.com/llms.txt)