VeredAi Knowledge API
Durchsuchen Sie die juristische Wissensdatenbank von VeredAi programmatisch: niederlaendische Gesetzgebung auf Artikelebene, Rechtsprechung mit vollstaendigen Entscheidungstexten und europaeische Gesetzgebung, ergaenzt durch Live-Ergebnisse aus den offiziellen Quellen.
Was Sie damit bauen koennen
Integrieren Sie aktuelle Gesetzesartikel und Rechtsprechung in Ihre eigenen Anwendungen, Aktensysteme oder internen Tools. Suchen Sie zweisprachig (Niederlaendisch und Englisch), filtern Sie nach Jurisdiktion und Dokumenttyp und rufen Sie vollstaendige Dokumente mit ueberpruefbarer Quellenangabe ab.
Authentifizierung
Erstellen Sie einen API-Schluessel unter Konto, API-Schluessel. Jeder Schluessel ist an genau einen Arbeitsbereich gebunden und erfordert ein Abonnement mit API-Zugriff. Senden Sie den Schluessel als Bearer-Token.
Authorization: Bearer vk_<jouw-sleutel>Endpoints
| GET /api/knowledge/search | q, lang (nl|en), jurisdiction (NL|BE|DE|EU), type (wetgeving|rechtspraak|eu|decentraal), area, law, date_from (JJJJ-MM-DD), date_to (JJJJ-MM-DD), limit (1-25), offset |
| GET /api/knowledge/documents/{uuid} | id, source, external_id, title, summary, body, url, language, jurisdiction, law_area, document_type, decision_date |
| GET /api/knowledge/health | status, latency_ms, last_success_at, failures_24h |
Beispiel
curl -H "Authorization: Bearer vk_..." \
"https://veredai.i-sight.nl/api/knowledge/search?q=transitievergoeding+ontslag&lang=nl&jurisdiction=NL&limit=5"Antwortformat
Jedes Suchergebnis enthaelt eine anklickbare Quell-URL, den externen Identifikator (BWB-Nummer mit Artikel, ECLI oder CELEX Nummer) und Metadaten zu Sprache, Jurisdiktion und Dokumenttyp. Der Meta-Block zeigt die Gesamtzahl, die konsultierten Quellen und die Aktualitaet des internen Wissensindex.
{
"data": [
{
"id": "7f0c2b1e-2f56-4a3e-9a53-1c9f4f2a6b77",
"source": "wetten.overheid.nl",
"external_id": "BWBR0005290:673",
"title": "Burgerlijk Wetboek Boek 7, artikel 673",
"snippet": "De werkgever is aan de werknemer een transitievergoeding verschuldigd indien ...",
"url": "https://wetten.overheid.nl/jci1.3:c:BWBR0005290&artikel=673",
"language": "nl",
"jurisdiction": "NL",
"document_type": "wetsartikel",
"decision_date": "",
"score": 6
}
],
"meta": {
"total": 14,
"sources_consulted": ["wetten.overheid.nl", "Rechtspraak.nl"],
"index_freshness": {"wetten": {"documents": 12500, "last_harvested": "2026-07-05 04:15:02"}}
}
}Codebeispiele
Derselbe Aufruf in PHP und JavaScript. Ersetzen Sie vk_... durch Ihren eigenen API-Schluessel.
PHP
$ch = curl_init('https://veredai.i-sight.nl/api/knowledge/search?q=' . urlencode('transitievergoeding ontslag') . '&limit=5');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer vk_...'],
]);
$result = json_decode((string) curl_exec($ch), true);
curl_close($ch);JavaScript
const response = await fetch(
'https://veredai.i-sight.nl/api/knowledge/search?q=transitievergoeding+ontslag&limit=5',
{ headers: { Authorization: 'Bearer vk_...' } }
);
const result = await response.json();Limits und Kosten
Pro Schluessel gilt ein konfigurierbares Limit pro Minute. Je nach Plattformkonfiguration koennen pro Anfrage Credits vom Arbeitsbereich abgebucht werden.
Administratoren koennen festlegen, dass eine feste Anzahl von Anfragen zusammen einen Credit kostet, zum Beispiel 1 Credit pro 10 Anfragen. Das aktuelle Limit und die Kosten fuer Ihren Arbeitsbereich stehen auf der Seite Konto, API-Schluessel.
Fehlerbehandlung
Fehler folgen immer demselben JSON-Format mit einem Code und einer lesbaren Meldung.
{"error": {"code": "rate_limit_exceeded", "message": "..."}}
401 missing_api_key | 401 invalid_api_key | 402 insufficient_credits
403 plan_required | 404 not_found | 422 invalid_parameters | 429 rate_limit_exceeded