{"uid":"cap_62QcYn1zxLd5ZM1B87lBt","slug":"agentsvc-io-holiday-lookup-api-2d513499","name":"agentsvc.io Holiday Lookup API","description":"86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.","url":"https://agentsvc.io/api/v1/proxy/holidays?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"string","description":"YYYY-MM-DD to check"},"year":{"type":"integer"},"region":{"type":"string","description":"State/region code, e.g. BY, CA, ZH"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code"},"language":{"type":"string","description":"Language for holiday names, e.g. en"},"include_observances":{"type":"boolean","default":false}}},"responseSchema":{"type":"json","example":{"data":{"year":2026,"count":14,"region":"BY","country":"DE","holidays":[{"date":"2026-01-01","name":"Neujahr","type":"public","substitute":false},{"date":"2026-01-06","name":"Heilige Drei Könige","type":"public","substitute":false}],"date_check":{"date":"2026-10-03","name":"Tag der Deutschen Einheit","weekday":"Saturday","is_holiday":true}},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_G3diaLwSuoQec7II7zAR9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns public holidays for a given country, region, and year, and checks whether a specific date is a holiday.","exampleAgentPrompt":"Can you check if October 3rd 2026 is a public holiday in Germany and also list all public holidays in Bavaria (BY) for 2026 in English?","exampleUseCases":[{"title":"Scheduling around German regional holidays","prompt":"I'm planning a delivery schedule for Bavaria in 2026 — can you get me all public holidays there so I know which days to skip? Use country DE, region BY, and return the names in English."},{"title":"Validating a contract deadline date","prompt":"Our contract deadline is set for January 6, 2026 in Germany — can you check if that's a public holiday so we know if we need to adjust?"},{"title":"Building a Switzerland holiday calendar in French","prompt":"Can you pull all public holidays in Switzerland for 2025 with names in French? I need them for our HR calendar tool."}],"resultDescription":"Returns a JSON object containing the year, country, region, total holiday count, and an array of holiday objects each with date, name, type, and substitute flag. If a specific date was provided, also returns a date_check object with the date's weekday, holiday name if applicable, and a boolean is_holiday field.","failureModes":["Unsupported country code returns an error or empty holiday list","Invalid date format (non-YYYY-MM-DD) may cause a validation error","Region code not recognized for the given country returns empty or error","Payment failure via x402 / insufficient USDC balance blocks the call","Missing required fields (country) may result in a 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need structured public holiday data for a specific country or subnational region, especially when you also need to validate whether a particular date falls on a holiday. It is particularly useful for scheduling, compliance, HR calendar generation, or date validation workflows where no API key setup is desired and per-call USDC micropayment via x402 is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:32:55.648Z","isFirstParty":false,"canonicalSlug":"agentsvc-io-holiday-lookup-api-2d513499"}