# FreeTier Agent API — Public Holidays Lookup

> FreeTier Agent API — Public Holidays Lookup is a paid API for AI agents from freetier-agent-api.pages.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-18).

Returns the list of public holidays for a given country and year (2026 or 2027) by ISO2 country code.

## Facts

- Endpoint: GET https://freetier-agent-api.pages.dev/api/holidays?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/freetier-agent-api-public-holidays-lookup-e6f8828f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yrYymx25OXeUfDE7rIKG4

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 freetier-agent-api-public-holidays-lookup-e6f8828f
```

Example prompt: What are all the public holidays in Denmark for 2026? I need the dates and names.

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call holiday lookup without signup, especially in agent workflows that require minimal friction. It's well-suited for agents that already operate on x402/USDC on Base and need to enrich scheduling, payroll, or travel data with official public holiday information for 2026 or 2027. It's less suitable if you need historical holiday data (pre-2026) or real-time holiday updates.

## Known failure modes

- Missing or invalid 'country' query parameter returns an error — must be a valid ISO2 country code
- Requesting a year outside the supported enum (2026 or 2027) returns a validation error
- Country codes not covered by the dataset may return an empty holidays array or a not-found error
- Payment failure via x402/USDC results in a 402 response and no data returned

## How this service works

Pay-per-call data API for AI agents: AI model prices and cost calculator, 4,259 MCP servers, email domain checks, text-to-JSON extraction, country/holiday/currency lookup, page and link checks, page-to-markdown, 2,230 verified APIs. x402, USDC on Base, no signup. Sources cited in every response.

## Output

Returns a JSON object containing the country ISO2 code, year, and an array of holiday objects — each with a date (YYYY-MM-DD) and the holiday name in the local language.

## 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"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "year": {
       "enum": [
        "2026",
        "2027"
       ],
       "type": "string"
      },
      "country": {
       "type": "string",
       "description": "ISO2"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2026,
  "country": "DK",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "Nytårsdag"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/freetier-agent-api-public-holidays-lookup-e6f8828f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from freetier-agent-api.pages.dev](https://www.zero.xyz/host/freetier-agent-api.pages.dev/llms.txt)