{"uid":"cap_p8sdBxjtXl9XHEoxfowCg","slug":"worldwide-holidays-lookup-api-8bc4cb5e","name":"Worldwide Holidays Lookup API","description":"Calendar and Japan data APIs for AI agents: worldwide holidays and business days (200+ countries), plus Japanese text-to-structure (address, name, bank, company normalization). Pay per call in USDC via x402, no API key.","url":"https://x402-ja-api.onrender.com/v1/holidays","method":"GET","headers":{},"bodySchema":{"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":"integer","maximum":2100,"minimum":1900},"types":{"type":"string","description":"Comma-separated filter: public,bank,school,optional,observance (default: all)"},"region":{"type":"string","maxLength":10,"description":"Optional subdivision (US-CA → CA, DE-BY → BY). GET /v1/holidays/countries?country=US lists them"},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"ISO 3166-1 alpha-2 country code (US, DE, GB, SG ...). GET /v1/holidays/countries lists all 200+"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"count":14,"region":"BY","source":"date-holidays (CC-BY-3.0)","country":"DE","holidays":[{"date":"2026-01-01","name":"New Year's Day","type":"public","localName":"Neujahr","substitute":false},{"date":"2026-01-06","name":"Epiphany","type":"public","localName":"Heilige Drei Könige","substitute":false}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QpBX0exHAAQSRM9R33pIO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns public holidays and observances for a given country and year, with optional subdivision filtering","exampleAgentPrompt":"What are all the public holidays in Germany, specifically in Bavaria (BY), for the year 2026?","exampleUseCases":[{"title":"Travel itinerary holiday awareness","prompt":"I'm planning a business trip to Singapore in 2025 — can you pull up all the public holidays there so I know which days offices will be closed?"},{"title":"Payroll calendar for US California","prompt":"Get me all public and bank holidays in California, US for 2025 so I can set up our payroll schedule correctly."},{"title":"International scheduling for remote team","prompt":"Our team has members in Japan, Germany, and Brazil — can you fetch the public holidays for all three countries for 2026 so we can plan around them when scheduling meetings?"}],"resultDescription":"Returns a JSON object with the year, country code, optional region, total holiday count, data source attribution, and an array of holiday objects each containing the date (YYYY-MM-DD), English name, local-language name, holiday type (public/bank/school/optional/observance), and a substitute-day flag.","failureModes":["Invalid or unsupported country code returns an error","Year outside 1900-2100 range is rejected by schema validation","Unknown region/subdivision code may return empty or error","Payment failure (x402) if USDC balance is insufficient","Network timeout if the Render.com service is cold-starting"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable holiday data for 200+ countries with optional subdivision granularity, holiday type filtering, and pay-per-call USDC pricing via x402 (no API key required). Prefer it over calendar libraries when you need authoritative, up-to-date data at runtime without bundling a local dataset.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:22.455Z","isFirstParty":false}