VeredAi

VeredAi Knowledge API

Doorzoek de juridische kennisbank van VeredAi programmatisch: Nederlandse wetgeving op artikelniveau, rechtspraak met volledige uitspraakteksten en Europese wetgeving, aangevuld met live resultaten uit de officiele bronnen.

Wat kun je ermee

Integreer actuele wetsartikelen en jurisprudentie in je eigen applicaties, dossiersystemen of interne tools. Zoek meertalig (Nederlands en Engels), filter op jurisdictie en documenttype, en haal volledige documenten op met een controleerbare bronverwijzing.

Authenticatie

Maak een API-sleutel aan onder Account, API-sleutels. Iedere sleutel is gekoppeld aan precies een werkruimte en vereist een abonnement met API-toegang. Stuur de sleutel mee als Bearer token.

Authorization: Bearer vk_<jouw-sleutel>

Endpoints

GET /api/knowledge/searchq, 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/healthstatus, latency_ms, last_success_at, failures_24h

Voorbeeld

curl -H "Authorization: Bearer vk_..." \
  "https://veredai.i-sight.nl/api/knowledge/search?q=transitievergoeding+ontslag&lang=nl&jurisdiction=NL&limit=5"

Antwoordformaat

Ieder zoekresultaat bevat een klikbare bron-URL, de externe identifier (BWB-nummer met artikel, ECLI of CELEX nummer) en metadata over taal, jurisdictie en documenttype. Het meta-blok toont het totaal, de geraadpleegde bronnen en de versheid van de eigen kennisindex.

{
  "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"}}
  }
}

Codevoorbeelden

Dezelfde aanroep in PHP en JavaScript. Vervang vk_... door je eigen API-sleutel.

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();

Limieten en kosten

Per sleutel geldt een instelbare snelheidslimiet per minuut. Afhankelijk van de platformconfiguratie kunnen per aanvraag credits van de werkruimte worden afgeschreven.

Beheerders kunnen instellen dat een vast aantal aanvragen samen een credit kost, bijvoorbeeld 1 credit per 10 aanvragen. De actuele limiet en kosten voor jouw werkruimte staan op de pagina Account, API-sleutels.

Foutafhandeling

Fouten volgen altijd hetzelfde JSON-formaat met een code en een leesbare melding.

{"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

Volledige OpenAPI-specificatie