API en integraties

CourtFull is open: een REST-API, een MCP-server voor AI-assistenten en een widget voor je eigen site. Gratis en zonder sleutel. Een referentie, geen juridisch advies.

REST-API

JSON over HTTPS, versie 1. Elke oorsprong mag de API aanroepen (CORS). Antwoorden voor een postcode of punt worden een dag gecachet.

GET /api/v1/courts

Het kanton en elke bevoegde rechtbank. Geef één van: address, postalCode, of lat en lon. lang=nl, fr of de kiest de taal van de namen. Rechtbanken met certain: false hangen af van de straat.

curl 'https://court-full.vercel.app/api/v1/courts?postalCode=9820'
curl 'https://court-full.vercel.app/api/v1/courts?address=Kerkstraat%2010%2C%202060%20Antwerpen&lang=fr'
curl 'https://court-full.vercel.app/api/v1/courts?lat=51.0543&lon=3.7174'

const res = await fetch('https://court-full.vercel.app/api/v1/courts?postalCode=9000&lang=nl')
const { cantons, courts } = await res.json()
// courts: [{ id, type, name, address, phone, email, website, certain, division? }, …]

GET /api/v1/court/{id}

Eén rechtbank of afdeling op id (uit /courts), met haar afdelingen.

curl 'https://court-full.vercel.app/api/v1/court/court-of-first-instance-oost-vlaanderen?lang=nl'

Fouten komen als JSON {"error": {"code", "message"}}, met status 400 (ongeldige vraag), 404 (niet gevonden) of 502 (adresregister onbereikbaar).

De volledige beschrijving in OpenAPI 3.1 /api/v1/openapi.json

Meer dan bevoegdheid

Dezelfde rekenregels als de site, als REST en als MCP-tool: een gemeente op (verkeerd getypte) naam of postcode (find_place), een geplakte brief lezen (read_court_letter), de inkomensgrenzen voor juridische bijstand met hun bronnen (legal_aid_check), interest op schuldvorderingen met betalingen (interest) en procedurele termijnen (procedural_deadline). Fouten hebben dezelfde vorm: { "error": { "code", "message" } }.

GET /api/v1/places · /legal-aid · /deadline

curl 'https://court-full.vercel.app/api/v1/places?q=Gnet'
curl 'https://court-full.vercel.app/api/v1/legal-aid?household=partner&dependants=2&income=2400'
curl 'https://court-full.vercel.app/api/v1/deadline?type=appeal&date=2026-06-20'

POST /api/v1/interest · /letters/analyze

curl 'https://court-full.vercel.app/api/v1/interest' -H 'Content-Type: application/json' \
  -d '{"claims":[{"principal":10000,"from":"2024-07-01"}],"payments":[{"date":"2025-01-01","amount":2000}],"asOf":"2025-07-01"}'
curl 'https://court-full.vercel.app/api/v1/letters/analyze' -H 'Content-Type: application/json' \
  -d '{"text":"Vonnis bij verstek … betekend op 10 maart 2026"}'

Een brief wordt alleen in het geheugen verwerkt: nooit bewaard of gelogd. Rijksregisternummers worden gemaskeerd vóór het lezen en in elk teruggegeven fragment. Hoogstens 20 kB; groter geeft 413.

MCP-server

Voor Claude en andere assistenten: Model Context Protocol over Streamable HTTP, met onder meer de tools find_courts, get_court en summons_deadline.

In Claude Code

claude mcp add --transport http courtfull https://court-full.vercel.app/api/mcp

In Claude (web of desktop): Instellingen → Connectors → Aangepaste connector toevoegen, met deze URL:

https://court-full.vercel.app/api/mcp

In de configuratie van een andere client:

{
  "mcpServers": {
    "courtfull": {
      "type": "http",
      "url": "https://court-full.vercel.app/api/mcp"
    }
  }
}

Probeer het uit

Stuur een echte aanvraag naar de API van deze site, zie het antwoord en neem de code mee voor je eigen software.

Playground laden…

Widget voor je site

Een zoekvak met de bevoegde rechtbanken, op je eigen site. Plak dit waar het moet komen: de hoogte past zich vanzelf aan.

<div data-courtfull data-lang="nl"></div>
<script src="https://court-full.vercel.app/embed.js" async></script>

data-lang (nl, fr, en) en data-theme (light, dark) zijn optioneel. Zonder script kan het ook met een iframe:

<iframe src="https://court-full.vercel.app/embed?lang=nl&theme=light" title="CourtFull"
        style="width:100%;height:420px;border:0"></iframe>

Voorbeeld

Browserextensie en Outlook

In de map extension/ van de broncode: een extensie voor Chrome en Firefox (rechtsklik op een geselecteerd adres, of een zoekvak in de werkbalk) en een Outlook-invoegtoepassing met de widget als taakvenster.

Vanuit je browser en telefoon

Gebruik CourtFull vanuit de adresbalk van je browser, deel een adres vanuit Google Maps of klik op een bladwijzer op eender welke website.

Bekijk de integraties