API Documentatie

DagenAftellen.nl biedt een eenvoudige, gratis API voor feestdagen, schoolvakanties en countdown-berekeningen. Alle responses zijn in JSON formaat.

Binnenkort beschikbaar

Basis-URL

https://test.dagenaftellen.nl/api

Authenticatie

De publieke API vereist geen authenticatie. Alle endpoints zijn vrij toegankelijk.

Rate limiting

Om de service betrouwbaar te houden hanteren we een limiet van 60 requests per minuut per IP-adres. Bij overschrijding ontvang je een 429 response.

Endpoints

GET/api/feestdagen

Alle Nederlandse feestdagen voor het huidige en komende jaar.

Voorbeeld response

[
  {
    "name": "Koningsdag",
    "slug": "koningsdag",
    "date": "2026-04-27",
    "isNationalHoliday": true
  },
  {
    "name": "Bevrijdingsdag",
    "slug": "bevrijdingsdag",
    "date": "2026-05-05",
    "isNationalHoliday": true
  }
]

GET/api/schoolvakanties

Schoolvakanties per regio (Noord, Midden, Zuid) voor het huidige schooljaar.

Voorbeeld response

[
  {
    "name": "Meivakantie",
    "slug": "meivakantie",
    "region": "noord",
    "startDate": "2026-04-25",
    "endDate": "2026-05-10"
  }
]

GET/api/countdown/:datum

Bereken het aantal dagen, uren, minuten en seconden tot een specifieke datum (YYYY-MM-DD).

Voorbeeld response

{
  "targetDate": "2026-12-25",
  "days": 284,
  "hours": 6812,
  "label": "Nog 284 dagen"
}

Vragen?

Heb je vragen over de API of wil je een integratie bespreken? Neem contact met ons op via [email protected].