# KalenderBase

> Officiële Belgische iCal kalender directory. Deadlines, feestdagen, schoolvakanties en meer als iCal-abonnementen en REST API.

KalenderBase verzamelt alle officiële Belgische kalenders — fiscale deadlines (BTW, personenbelasting, vennootschapsbelasting, RSZ), feestdagen, schoolvakanties, parlementszittingen, FSMA en NBB publicaties — op één plek. Gebruikers kunnen kalenders abonneren via iCal (Google Calendar, Outlook, Apple Calendar) of consumeren via de REST API.

## API Integratie

- **API Documentatie**: /developers
- **OpenAPI 3.0 spec**: /api/v1/openapi.json
- **Base URL**: /api/v1
- **Authenticatie**: HTTP header `X-API-Key: kb_live_...` of query parameter `?api_key=kb_live_...`
- **API keys aanmaken**: Inloggen op /app → Account → API Keys, of POST /api/v1/keys

## Belangrijkste endpoints

- `GET /api/v1/calendars` — Lijst alle kalenders (filter op category, tier)
- `GET /api/v1/calendars/{slug}` — Detail van één kalender met preview events
- `GET /api/v1/calendars/{slug}/events` — Alle events (filter op year, from, to)
- `GET /api/v1/search?q={term}` — Zoek in kalenders én event titels
- `GET /api/v1/events/upcoming?days=30` — Komende events over alle kalenders
- `GET /api/v1/categories` — Overzicht categorieën

## iCal Feeds

- Gratis kalenders: `/ical/public/{slug}.ics` — geen authenticatie vereist
- Betaalde kalenders: `/ical/feed/{userToken}/{slug}.ics` — token in profiel
- Alle abonnementen gecombineerd: `/ical/feed/{userToken}/all.ics`

## Kalender categorieën

- `fiscaal` — BTW kwartaal/maand, personenbelasting, vennootschapsbelasting, voorafbetalingen, roerende voorheffing
- `sociale-zekerheid` — RSZ kwartaalaangiftes, zelfstandigen bijdragen
- `vennootschappen` — NBB jaarrekeningen, KBO & Staatsblad, algemene vergadering
- `overheid` — Belgische feestdagen, parlement, verkiezingen
- `onderwijs` — Schoolvakanties Vlaanderen, Wallonië, Brussel
- `financieel` — FSMA publicaties, NBB statistieken, EU Parlement

## Rate limits

- Free plan: 100 API verzoeken/dag
- Paid plan: 2000 API verzoeken/dag
- Headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Plan`

## Authenticatie voorbeeld

```http
GET /api/v1/calendars HTTP/1.1
Host: kalenderbase.be
X-API-Key: kb_live_your_key_here
```

```http
GET /api/v1/events/upcoming?days=60&category=fiscaal HTTP/1.1
Host: kalenderbase.be
X-API-Key: kb_live_your_key_here
```

## Gebruik voor AI agents

Deze API is geschikt voor AI-assistenten en automatiseringsworkflows die:
- Belgische fiscale deadlines willen opzoeken of monitoren
- Kalenderdata willen integreren in planningstools
- Deadlineherinneringen willen versturen op basis van aankomende events
- Boekhoud- of ERP-software willen aanvullen met officiële Belgische datums

## Contact

- Website: https://kalenderbase.be
- API support: api@kalenderbase.be
- Developers: https://kalenderbase.be/developers