# CertainData Public Holidays API

> CertainData Public Holidays API is a paid API for AI agents from api.certaindata.ai, paid per call via x402, $0.007/call, status unknown (last checked 2026-09-15).

Returns a dated list of public holidays for a given country (ISO-2 code) and year, optionally filtered by holiday type.

## Facts

- Endpoint: GET https://api.certaindata.ai/ca054d66abad4d6ea80ba43013b61743-cd/holidays/:iso2/:year
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/certaindata-public-holidays-api-addaa788
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9sIjcO6c1SEHj_0GzKjRZ

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 certaindata-public-holidays-api-addaa788
```

Example prompt: Can you pull the full list of public holidays for Germany in 2026, including both public and bank holidays?

## When to prefer this

Use this endpoint when you need an authoritative, structured list of public or bank holidays for a specific country and year. Prefer it over scraping or general-purpose web search when you need clean, machine-readable holiday data for scheduling, compliance, or calendar enrichment tasks. Ideal for building business logic that avoids scheduling on public holidays across multiple countries.

## Known failure modes

- Invalid ISO-2 country code returns an error or empty result
- Unsupported country returns no holiday data
- Year out of supported range returns an error or empty list
- Invalid holiday type filter returns no results
- Malformed path parameters (e.g. non-numeric year) return a 400-level error

## How this service works

Dated public-holiday list for a country and year.

## Output

A dated list of public holidays for the specified country and year, each entry including the holiday name, date, and type (e.g. public or bank). The response covers all official holidays unless filtered by type via the optional query parameter.

## 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",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "iso2",
      "year"
     ],
     "properties": {
      "iso2": {
       "type": "string",
       "description": "Country ISO-2 code, e.g. GB."
      },
      "year": {
       "type": "string",
       "description": "Four-digit year, e.g. 2026."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "type": {
       "type": "string",
       "description": "Optional. Filter by holiday type, e.g. public or bank. Omit for all."
      }
     }
    }
   },
   "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/certaindata-public-holidays-api-addaa788/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.certaindata.ai](https://www.zero.xyz/host/api.certaindata.ai/llms.txt)