# FastX402 Public Holidays Lookup > FastX402 Public Holidays Lookup is a paid API for AI agents from fastx402.tools, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-18). Returns a list of public holidays for a given country and year, including holiday names, dates, types, and regional applicability. ## Facts - Endpoint: GET https://fastx402.tools/public-holidays?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-18 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/fastx402-public-holidays-lookup-ae6a5f8f - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h9K5SQSZbuTLrP8jDovhv 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 fastx402-public-holidays-lookup-ae6a5f8f ``` Example prompt: What are all the public holidays in Germany for 2026, including which ones are nationwide versus regional? ## When to prefer this Choose this endpoint when you need accurate, structured public holiday data for a specific country and year, especially when you need regional vs. nationwide breakdowns and local-language holiday names. Ideal for scheduling, date validation, calendar enrichment, and business logic that must account for local holidays. Useful when you want to avoid requiring an account or API key and prefer pay-per-call pricing. ## Known failure modes - Invalid or unsupported country code returns an error or empty result - Year outside supported range 1975-2075 returns a validation error - Missing required query parameters (country or year) returns a 400-level error - Network or payment failure (x402 payment not processed) returns a 402 Payment Required response ## How this service works 200 pay-per-call tools for AI agents, from $0.001 per request in USDC on Base or Solana with x402. No account, no API key. ## Output A JSON object containing the country code, year, total holiday count, nationwide holiday count, and an array of holiday objects each with a date (YYYY-MM-DD), English name, local language name, type(s) (e.g. 'Public'), a list of applicable county/region codes (or null if nationwide), and a boolean indicating if the holiday is nationwide. ## 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", "year" ], "properties": { "year": { "type": "string", "description": "Year, 1975-2075" }, "country": { "type": "string", "description": "2-letter country code, e.g. DE, US, TR, GB" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "properties": { "year": { "type": "integer" }, "count": { "type": "integer" }, "country": { "type": "string" }, "holidays": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "name": { "type": "string" }, "types": { "type": "array", "items": { "type": "string" } }, "counties": { "type": "null" }, "local_name": { "type": "string" }, "nationwide": { "type": "boolean" } } } }, "nationwide_count": { "type": "integer" } } } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "year": 2026, "count": 19, "country": "DE", "holidays": [ { "date": "2026-01-01", "name": "New Year's Day", "types": [ "Public" ], "counties": null, "local_name": "Neujahr", "nationwide": true }, { "date": "2026-01-06", "name": "Epiphany", "types": [ "Public" ], "counties": [ "DE-BW", "DE-BY", "DE-ST" ], "local_name": "Heilige Drei Könige", "nationwide": false }, { "date": "2026-03-08", "name": "International Women's Day", "types": [ "Public" ], "counties": [ "DE-BE", "DE-MV" ], "local_name": "Internationaler Frauentag", "nationwide": false }, { "date": "2026-04-03", "name": "Good Friday", "types": [ "Public" ], "counties": null, "local_name": "Karfreitag", "nationwide": true }, { "date": "2026-04-05", "name": "Easter Sunday", "types": [ "Public" ], "counties": [ "DE-BB" ], "local_name": "Ostersonntag", "nationwide": false }, { "date": "2026-04-06", "name": "Easter Monday", "types": [ "Public" ], "counties": null, "local_name": "Ostermontag", "nationwide": true }, { "date": "2026-05-01", "name": "Labour Day", "types": [ "Public" ], "counties": null, "local_name": "Tag der Arbeit", "nationwide": true }, { "date": "2026-05-14", "name": "Ascension Day", "types": [ "Public" ], "counties": null, "local_name": "Christi Himmelfahrt", "nationwide": true }, { "date": "2026-05-24", "name": "Pentecost", "types": [ "Public" ], "counties": [ "DE-BB" ], "local_name": "Pfingstsonntag", "nationwide": false }, { "date": "2026-05-25", "name": "Whit Monday", "types": [ "Public" ], "counties": null, "local_name": "Pfingstmontag", "nationwide": true }, { "date": "2026-06-04", "name": "Corpus Christi", "types": [ "Public" ], "counties": [ "DE-BW", "DE-BY", "DE-HE", "DE-NW", "DE-RP", "DE-SL" ], "local_name": "Fronleichnam", "nationwide": false }, { "date": "2026-08-15", "name": "Assumption Day", "types": [ "Public" ], "counties": [ "DE-SL" ], "local_name": "Mariä Himmelfahrt", "nationwide": … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fastx402-public-holidays-lookup-ae6a5f8f/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from fastx402.tools](https://www.zero.xyz/host/fastx402.tools/llms.txt)