Developers API - Juridische AI Loket

Quickstart

In 3 stappen aan de slag met de Juridische AI Loket API

Stap 1 — Haal een API sleutel op

Maak een API sleutel aan via de sleutelbeheer sectie onderaan deze pagina. Je sleutel begint altijd met jak_

Stap 2 — Test de verbinding

curl https://juridische-loket.replit.app/api/v1/status \
  -H "X-API-Key: jak_uw_sleutel_hier"

import requests

headers = {"X-API-Key": "jak_uw_sleutel_hier"}
r = requests.get(
    "https://juridische-loket.replit.app/api/v1/status",
    headers=headers
)
print(r.json())

const response = await fetch('https://juridische-loket.replit.app/api/v1/status', {
  headers: { 'X-API-Key': 'jak_uw_sleutel_hier' }
});
const data = await response.json();
console.log(data);

Stap 3 — Genereer uw eerste document

curl -X POST https://juridische-loket.replit.app/api/v1/documents/generate \
  -H "X-API-Key: jak_uw_sleutel_hier" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "Betalingsverzoek",
    "situation": "Mijn klant heeft factuur 2024-042 van €1.500 al 60 dagen niet betaald."
  }'

Authenticatie

Alle API verzoeken vereisen een geldige API sleutel in de header

Voeg de X-API-Key header toe aan elk verzoek:

X-API-Key: jak_uw_sleutel_hier

Of via de Authorization header:

Authorization: Bearer jak_uw_sleutel_hier

Deel uw API sleutel nooit publiek. Sla hem op als omgevingsvariabele in uw applicatie.

Rate Limits

Dagelijkse limieten per abonnement

Abonnement	API verzoeken/dag	Document credits/maand	AI Chat
Gratis	10	2	—
Starter (€9,95)	100	10	✓
Pro (€19,95)	500	25	✓
Zakelijk (€49,95)	2.000	50	✓

Bij het bereiken van de limiet ontvangt u een 429 Too Many Requests respons. Limieten resetten om middernacht (UTC).

Templates opvragen

GET /api/v1/templates

Geeft een lijst van alle beschikbare document templates terug.

{
  "templates": [
    { "name": "Betalingsverzoek" },
    { "name": "Contractbeëindiging" },
    { "name": "Sommatie- en stakingsverzoek" },
    { "name": "ZZP Overeenkomst" },
    { "name": "Brief van een advocaat" }
  ],
  "count": 8
}

Document genereren

POST /api/v1/documents/generate

Genereert een professioneel juridisch document met AI. Verbruikt 1 credit.

Parameters

Naam	Type	Vereist	Omschrijving
template	string	verplicht	Naam van het document template
situation	string	verplicht	Beschrijving van de situatie (max 3000 tekens)

Voorbeeld verzoek

POST /api/v1/documents/generate
Content-Type: application/json
X-API-Key: jak_uw_sleutel_hier

{
  "template": "Betalingsverzoek",
  "situation": "Klant Jan de Vries heeft factuur #2024-042
    van €2.500 al 45 dagen niet betaald ondanks herinneringen."
}

Voorbeeld respons

{
  "document_id": 142,
  "template": "Betalingsverzoek",
  "content": "Geachte heer De Vries,\n\nHierbij...",
  "credits_remaining": 24,
  "created_at": "2026-04-06T14:30:00"
}

AI Juridisch Chat

Vereist minimaal een Starter abonnement.

POST /api/v1/chat

Stel een juridische vraag aan de AI-jurist gespecialiseerd in Nederlands recht.

Naam	Type	Vereist	Omschrijving
question	string	verplicht	De juridische vraag (max 2000 tekens)

POST /api/v1/chat
X-API-Key: jak_uw_sleutel_hier

{ "question": "Wat zijn mijn rechten als mijn verhuurder de huur
  wil verhogen met 15%?" }

// Respons
{
  "question": "Wat zijn mijn rechten...",
  "answer": "Op basis van artikel 7:252 BW...",
  "disclaimer": "Dit is algemeen juridisch advies..."
}

Juridische Artikelen

GET /api/v1/articles

Haal een lijst van gepubliceerde juridische artikelen op.

Parameter	Type	Omschrijving
category	string	Filter op categorie (bijv. arbeidsrecht)
type	string	Filter op type: tips, nieuws, gids, faq
limit	integer	Resultaten per pagina (max 100, standaard 20)
offset	integer	Paginering offset

GET /api/v1/articles/{slug}

Haal de volledige inhoud van één artikel op inclusief de volledige tekst.

Account informatie

GET /api/v1/account

Geeft informatie over het account dat bij de API sleutel hoort, inclusief credits en limieten.

{
  "username": "jandevries",
  "subscription_tier": "pro",
  "subscription_name": "Pro",
  "credits_remaining": 24,
  "api_requests_today": 12,
  "api_daily_limit": 500
}

OpenAPI 3.1 Specificatie

Machineleesbare beschrijving van de volledige API — voor tools, platforms en AI-assistenten

De OpenAPI spec beschrijft alle endpoints, parameters en responses in een standaardformaat. Tools zoals Postman, Swagger UI en ChatGPT kunnen deze spec automatisch inlezen om de API te begrijpen en te gebruiken.

openapi.json downloaden Bekijk in Swagger Editor

Directe URL van de spec

https://juridische-loket.replit.app/api/v1/openapi.json

ChatGPT Actions instellen

Verbind de API direct aan een Custom GPT in ChatGPT

Met ChatGPT Actions kunt u een Custom GPT aanmaken die juridische documenten kan genereren en vragen kan beantwoorden via uw account — rechtstreeks vanuit het ChatGPT-interface.

Ga naar chat.openai.com → Explore GPTs → Create
Klik op het Configure tabblad
Scroll naar Actions en klik op Create new action
Kies Import from URL en plak:

https://juridische-loket.replit.app/api/v1/openapi.json

Voeg bij Authentication type API Key in, met header naam X-API-Key
Vul uw API sleutel in (aanmaken onderaan deze pagina)
Sla op en test

Uw Custom GPT kan nu vragen stellen zoals: "Maak een betalingsverzoek voor klant X die €500 schuldig is" — en krijgt direct een professioneel document terug.

MCP Server

Model Context Protocol — laat AI-assistenten uw juridische kennis gebruiken

De MCP server stelt AI-assistenten zoals Claude in staat om direct verbinding te maken met onze juridische kennisbasis. In plaats van dat gebruikers naar uw platform toe moeten komen, haalt de AI de informatie actief op.

🔍

Artikelen zoeken

AI vindt relevante juridische content

📄

Documenten genereren

Rechtstreeks vanuit AI-assistenten

⚖️

Juridisch advies

AI-jurist via elke interface

MCP Tools

Beschikbare tools op POST /mcp

search_legal_articles

Zoek juridische artikelen op trefwoord en categorie

Gratis

get_legal_article

Haal de volledige inhoud van een artikel op

Gratis

list_document_templates

Lijst van beschikbare document templates

Gratis

generate_legal_document

Genereer een juridisch document (verbruikt 1 credit)

API sleutel vereist

ask_legal_question

Stel een juridische vraag aan de AI-jurist

Starter+ vereist

MCP Configuratie

Verbind Claude Desktop of andere MCP-clients

Voeg dit toe aan uw Claude Desktop configuratiebestand (claude_desktop_config.json):

claude_desktop_config.json

{
  "mcpServers": {
    "juridische-ai-loket": {
      "command": "npx",
      "args": ["-y", "mcp-remote"],
      "env": {
        "MCP_SERVER_URL": "https://juridische-loket.replit.app/mcp"
      }
    }
  }
}

Of test direct met een HTTP verzoek:

curl -X POST https://juridische-loket.replit.app/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_legal_articles",
      "arguments": {
        "query": "huurverhoging rechten huurder",
        "category": "huurrecht",
        "limit": 3
      }
    }
  }'

API Sleutels beheren

Maak en beheer uw API sleutels

Inloggen vereist

Log in om API sleutels aan te maken en te beheren.

Inloggen

Developer API

claude_desktop_config.json

Inloggen vereist