Feest dagen API
Vraag feestdagen op voor 100+ landen en elk jaar in één API-aanroep. Volledig lokale berekening — geen externe databronnen, geen rate-limit-verrassingen.
Heb je geen API key?
Meld je aan bij je account om je API keys aan te maken en te beheren.
Integratiegids
Kopieer een snippet, vervang je API key, draaien. Werkt in elke HTTP-client — voorbeelden hieronder in cURL, JavaScript en Python.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringverplichtISO 3166-1 alpha-2 country code US
yearintegeroptioneel4-digit year (defaults to current year) 2026
curl -X GET "https://www.apipick.com/api/holidays" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "Holidays retrieved successfully",
"data": {
"country": "US",
"country_name": "United States",
"year": 2026,
"total": 11,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day"
},
{
"date": "2026-01-19",
"name": "Martin Luther King Jr. Day"
},
{
"date": "2026-02-16",
"name": "Presidents' Day"
},
{
"date": "2026-05-25",
"name": "Memorial Day"
},
{
"date": "2026-07-03",
"name": "Independence Day (observed)"
},
{
"date": "2026-09-07",
"name": "Labor Day"
},
{
"date": "2026-10-12",
"name": "Columbus Day"
},
{
"date": "2026-11-11",
"name": "Veterans Day"
},
{
"date": "2026-11-26",
"name": "Thanksgiving Day"
},
{
"date": "2026-12-25",
"name": "Christmas Day"
}
]
},
"credits_used": 1,
"remaining_credits": 99
}Gebouwd voor planning in de praktijk
HR-planning
Sluit feestdagen automatisch uit bij het berekenen van verlofsaldi, salariscycli en dienstroosters in meerdere landen.
Beurskalenders
Sla niet-handelsdagen over in financiële modellen en backtests. Identificeer bankvrije dagen die de afwikkelings- en clearingvensters beïnvloeden.
Logistieke ETA's
Bereken nauwkeurige leverdatums door feestdagen in de landen van herkomst, doorvoer en bestemming automatisch over te slaan.
n8n-automatisering
Koppel aan n8n- of Zapier-workflows om tijdgevoelige acties te beheren — sla het versturen van e-mails of rapporten over op nationale feestdagen.
Alternatief voor HolidayAPI & Nager.Date
Data van het huidige jaar, planning voor toekomstige jaren en een productie-SLA — zonder de jaarvergrendeling van het gratis niveau of het betrouwbaarheidsrisico van een community-project.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Gratis niveau | Alleen vorig jaar | Gratis (geen SLA) | 100 credits bij aanmelding |
| Data huidig jaar | Alleen betaald plan | ✓ | ✓ |
| Data toekomstig jaar | Alleen betaald plan | ✓ (beperkt) | ✓ tot +10 jaar |
| Historische data (1900+) | Alleen betaald plan | Gedeeltelijk | ✓ vanaf 1900 |
| Productie-SLA | Alleen betaalde plannen | ✗ Community-project | ✓ |
| Gedekte landen | ~100 | ~110 | 100+ |
| Geen creditcard om te starten | ✗ | ✓ | ✓ |
| Verlopen credits / verzoeken? | Jaarplan | N/A | Verlopen nooit |
| Klaar voor AI-agent / LLM | Gedeeltelijk | Gedeeltelijk | ✓ Native JSON |
De gratis-niveau-val van HolidayAPI
Het gratis plan van HolidayAPI is opzettelijk beperkt tot alleen het vorige kalenderjaar. Moet je feestdagen voor het huidige jaar opzoeken of vooruitplannen voor verlofschema's van 2027? Dan moet je upgraden naar een betaald plan. Voor elke planning- of automatiseringssituatie maakt dit het gratis niveau vanaf dag één praktisch onbruikbaar.
Het betrouwbaarheidsrisico van Nager.Date
Nager.Date is een door de community onderhouden open-source-project — gratis te gebruiken, maar met geen uptime-SLA, geen supportcontract en geen garantie op blijvende beschikbaarheid. Teams die er salarissystemen of logistieke pipelines op hebben gebouwd, zijn verrast door onverwachte downtime of stopzetting. Prima voor prototyping; niet voor productie.
Reactievelden
| Veld | Type | Beschrijving |
|---|---|---|
| data.country | string | ISO 3166-1 alpha-2-landcode (hoofdletters) |
| data.country_name | string | Volledige Engelse naam van het land |
| data.year | integer | Het opgevraagde kalenderjaar |
| data.total | integer | Aantal feestdagen in het jaar |
| data.holidays | array | Lijst van feestdagobjecten gesorteerd op datum |
| data.holidays[].date | string | Feestdagdatum in het formaat YYYY-MM-DD |
| data.holidays[].name | string | Officiële naam van de feestdag |
| credits_used | integer | Voor dit verzoek afgeschreven credits |
| remaining_credits | integer | Resterende credits in je account |
Rate limits
Throttling is per API key, een verschuivend venster van 60 seconden. Bereik je de limiet, dan krijg je een nette 429 met een Retry-After-header.
120req/min
Per API key, per endpoint. Verschuivend venster van 60 seconden.
3concurrent
Max. gelijktijdig lopende verzoeken per API key.
X-RateLimit-LimitMaximaal toegestane verzoeken per minuutX-RateLimit-RemainingResterende verzoeken in het huidige vensterX-RateLimit-ResetSeconden tot het huidige venster opnieuw startRetry-AfterSeconden te wachten voor opnieuw proberen (alleen bij 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Veelgestelde vragen
V: Welke landen worden ondersteund?
A: 100+ landen via de open-source-bibliotheek python-holidays (vacanza). Dit omvat de VS, het VK, Duitsland, Frankrijk, Japan, China, Australië, Canada, India, Brazilië en het grootste deel van Europa, Azië, Latijns-Amerika en Afrika. Gebruik een geldige ISO 3166-1 alpha-2-code (bijv. US, GB, DE).
V: Hoe ver terug en vooruit kan ik query's doen?
A: Je kunt elk jaar opvragen van 1900 tot 10 jaar in de toekomst. Historische feestdagen worden berekend op basis van de regels die destijds van kracht waren, dus resultaten weerspiegelen de werkelijke historische vieringen in plaats van de huidige regels teruggeprojecteerd.
V: Zijn regionale/provinciale feestdagen inbegrepen?
A: Dit endpoint geeft alleen nationale feestdagen terug. Vieringen op staat-, provincie- of regioniveau (bijv. Amerikaanse staatsfeestdagen, Duitse Länder-feestdagen) zijn niet inbegrepen in de standaardreactie. Neem contact op als je feestdagdata op subdivisieniveau nodig hebt.
V: Kunnen AI-agents dit als tool gebruiken?
A: Ja. Het endpoint neemt twee queryparameters (country en year) en geeft een gestructureerde JSON-array terug — rechttoe rechtaan te definiëren als tool-functie voor OpenAI, Claude, LangChain of elk agent-framework. Ideaal voor planningsagents die moeten redeneren over werkdagen in meerdere landen.
Gebruik Public Holidays in Claude Code en AI-agents
Installeer de officiële Claude Code-skill om feestdagen voor 100+ landen rechtstreeks in je AI-coding-agent op te vragen — gesorteerde datums, officiële namen en aantallen via natuurlijke taal.
Vraag het je AI-agent op een natuurlijke manier
Compatibele platforms
Claude Code-skill voor de APIpick Public Holidays API
Geeft feestdaglijsten gesorteerd op datum terug met officiële Engelse namen en totaalaantallen voor 100+ landen. Ondersteunt jaren van 1900 tot 10 jaar vooruit.