lookup · calendar
Public holidays by country and year
Look up the public holidays for any of about 250 countries and regions by year, with optional subdivision, language, and category filtering; each lookup costs 1 credit after the 20 free runs a day and completes within 10 seconds.
result
Press Run. The result lands here, made by the real tool.
1 credit · ≤10 s · no login · 20 free/day
Keys are stored in this browser only. A key lets you buy credits and keep going after the free runs.
How it works
- Enter a country code, year, and any optional subdivision, language, or category filters in the form fields.
- Press Run to retrieve the holiday list.
- Read the returned JSON, which includes each holiday date and name alongside the country, year, subdivision, and total count.
Limits
Each lookup accepts up to 4,096 bytes of input and must complete within 10 seconds. You get 20 free runs per day without logging in. After that, each run costs 1 credit drawn from prepaid credits attached to an API key.
Privacy
Your input is processed for the request and discarded immediately afterwards; it is not stored or used for any other purpose. Usage records retain only the time, tool name, status, duration, credits used, and a salted hash of the IP address.
More tools
- Currency ratesLatest and historical euro foreign exchange reference rates from the European Central Bank, with conversion between any two of its currencieslookup
- DNS lookupLook up A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV or PTR records of a public name through the Cloudflare and Google public resolverslookup
- IP lookupReverse DNS name and registry record (network block, name, country) of a public IP address, from open registry data onlylookup
- ISO codesLook up ISO 3166 country and subdivision codes, ISO 4217 currency codes and ISO 639 language codes by code or name fragmentlookup
- RDAP lookupLook up the public registration record of a domain, IP address or AS number from its registry's RDAP service, without personal contact datalookup
Call it from code
curl -sS -X POST 'https://data.voiddo.com/v1/holidays_lookup' \
-H 'Content-Type: application/json' \
-d '{"country":"US","year":2026}'20 calls a day need no key. Beyond that: one-time credit packs, $5 for 500 credits, $9 for 1,000 credits, $29 for 4,000 credits. Get credits · llms.txt · OpenAPI.
Questions
Do I need an account to use this?
No. You get 20 free runs per day per visitor with no login required.
How do I call this from code?
Send a POST request to https://data.voiddo.com/v1/holidays_lookup with your parameters as JSON; a curl example is shown on this page.
What happens once I exceed the 20 free runs?
Further runs that day cost 1 credit each, drawn from prepaid credits attached to your API key.
Can I filter by subdivision or holiday category?
Yes. You can pass a state, province, or region code and one or more categories such as public, bank, school, government, optional, or half_day.
Is my input stored after the lookup?
No. The input is discarded after the request completes and is not kept or used for anything else.