Basis-info

Base URL: https://subsidieai-pro-api.fly.dev
Authenticatie: Bearer JWT via Authorization: Bearer <token>
Rate limits: 60 req/min per IP (publieke endpoints), 600 req/min (ingelogd)
OpenAPI: openapi.json · Swagger UI
CORS: alleen subsidievinder.nl + localhost:3000 toegestaan

KVK Handelsregister

/api/kvk · Geen auth (publiek)

GET/api/kvk/zoek?q={query}&limit=8

Autocomplete op bedrijfsnaam of KVK-nummer

GET/api/kvk/{kvk_nummer}

Volledig bedrijfsprofiel — naam, SBI, adres, medewerkers

GET/api/kvk/stats

Databank-statistieken: aantallen per bron / provincie

POST/api/kvk/admin/sync-wikidata🔒 admin

Bulk-sync Wikidata → DB cache (admin, CRON-secret)

Regelingen (RVO + DUS-I)

/api/regelingen · Gemixt

GET/api/regelingen🔒 bearer

Lijst interne seed-regelingen

GET/api/regelingen/rvo?q=&sector=&limit=

Live RVO data (50 regelingen, 6u cached)

GET/api/regelingen/rvo/recent?dagen=14

Recent gewijzigd in N dagen

Lead capture & e-mail

/api/leads · Geen auth (publiek)

POST/api/leads/wbso-calc

WBSO calculator e-mail capture + resultaat-mail

{"email":"a@b.nl","input":{...},"resultaat":{"totaalVoordeel":31680}}

POST/api/leads/kalender

Exit-intent / nieuwsbrief signup

{"email":"a@b.nl","source":"exit_intent","path":"/scan"}

GET/api/leads/count

Publiek tellertje (social proof)

GET/api/leads/list?limit=100🔒 admin

Admin lijst

GET/api/leads/csv?limit=1000🔒 admin

CSV export voor Excel/Sheets

Billing (Stripe)

/api/billing · Bearer / Stripe-signature

GET/api/billing/public-checkout-url?plan=starter|professional

Marketing CTA — geeft Stripe of register-fallback URL

POST/api/billing/checkout🔒 bearer

Interne checkout flow (ingelogd)

POST/api/billing/webhook

Stripe events (signature verify met STRIPE_WEBHOOK_SECRET)

POST/api/billing/customer-portal🔒 bearer

Stripe Billing Portal redirect

Subsidiekalender

/api/kalender · Geen auth (publiek)

GET/api/kalender/pdf

2-page PDF van 20 openstellingen 2026 (24u cached)

GET/api/kalender/ical

iCal-feed voor Google Cal / Outlook import

Affiliate

/api/affiliate · Open

POST/api/affiliate/register

Schrijf nieuwe affiliate in — krijg unieke code

POST/api/affiliate/click

Track click via ?ref=CODE landing

POST/api/affiliate/conversion

Track lead/trial/paid conversie

GET/api/affiliate/{code}/stats

Dashboard data voor één affiliate

GDPR (AVG Art. 15 + 17)

/api/gdpr · Bearer (ingelogd)

GET/api/gdpr/my-data🔒 bearer

JSON export persoonsgegevens (Art. 15)

GET/api/gdpr/my-data.zip🔒 bearer

ZIP-download met JSON + README

POST/api/gdpr/request-deletion🔒 bearer

Markeer account voor deletion in 30 dagen (Art. 17)

Errors & monitoring

/api/errors · Geen auth (publiek POST)

POST/api/errors

Client error capture (vanuit SentryInit)

GET/api/errors/recent?limit=50🔒 admin

Admin view laatste errors

API toegang

Bearer-tokens beschikbaar voor Enterprise-klanten. Vraag toegang aan via api@subsidievinder.nl.

REST API reference