Nederlandse bedrijfsdata API

Een bedrijfsdata API die ook laat zien waarom een match klopt.

Stuur een gedeeltelijk bedrijfsrecord en ontvang maximaal vijf kandidaten met matchstatus, confidence, methode en evidence. Voor duurzame verrijking start je daarna een afzonderlijke enrichmentjob.

Bekijk de quickstart Vraag een pilot-key aan
EVIDENCE-FIRSTVan invoer naar een uitlegbaar besluit.
Bron per voorstel Review bij twijfel Origineel blijft bewaard
Waar dit bij helpt

Maak een databesluit controleerbaar vóór je het toepast.

01

Match vóór verrijking

Scheid het vinden van de juiste organisatie van het aanvullen van velden. Zo blijft zichtbaar waar onzekerheid ontstaat.

02

Bewijs in het contract

Kandidaten bevatten methode, confidence en evidence. Een probable of ambiguous antwoord wordt niet als zekerheid gepresenteerd.

03

Single record en CSV

Gebruik resolve voor een directe kandidaatselectie en async jobs voor enrichment, reviewbestanden en definitieve exports.

Werkbare route

Van eerste signaal tot veilig resultaat.

  1. 01

    Stuur een identiteitssignaal

    Naam, KVK-nummer, btw-nummer, website, contactgegeven of een genest adres is voldoende om te beginnen.

  2. 02

    Beoordeel de resolve-status

    De API antwoordt met verified, probable, ambiguous of unmatched en maximaal vijf gerangschikte kandidaten.

  3. 03

    Start enrichment waar nodig

    Gebruik een unieke Idempotency-Key om een duurzame single-recordjob te starten zonder dubbele verwerking.

  4. 04

    Pas alleen het eindresultaat toe

    Verwerk final_data of result.csv nadat automatische regels en eventuele menselijke review zijn afgerond.

Synthetisch voorbeeld · geen klantdata

Het echte resolve-contract in één request.

De postcode staat binnen address en de response bevat candidates in het meervoud. Resolve geeft direct een matchresultaat; enrich start een aparte 202-job.

Alleen de request gebruikt fictieve invoer. Een werkelijke uitkomst mag uitsluitend uit de live API-response komen.

Request · POST /v1/companies/resolve
{
  "record": {
    "external_id": "crm-1042",
    "name": "Voorbeeldbedrijf B.V.",
    "address": {
      "postal_code": "1234 AB",
      "country_code": "NL"
    }
  }
}
Contracttype · geen vooraf ingevulde output
type ResolveResponse = {
  status:
    | "verified"
    | "probable"
    | "ambiguous"
    | "unmatched";
  confidence: number; // 0..1
  candidates: Array<{
    organization_id: string | null;
    display_name: string;
    kvk_number: string | null;
    website_url: string | null;
    city: string | null;
    confidence: number; // 0..1
    method: string;
    hard_identifier: boolean;
    evidence: string[];
  }>;
};

Wanneer resolve genoeg is

Gebruik resolve wanneer je tijdens invoer of import wilt weten welke organisatie waarschijnlijk wordt bedoeld, zonder al een duurzame reparatiejob te starten.

  • Directe kandidaatselectie
  • Maximaal vijf kandidaten
  • Geen stilzwijgende writeback

Wanneer enrichment past

Gebruik enrich of een CSV-job wanneer het resultaat bewaard, per veld onderbouwd en zo nodig door een medewerker beoordeeld moet worden.

  • Idempotente verwerking
  • Review- en resultaatbestand
  • Evidence per veldvoorstel
Veelgestelde vragen

Eerst weten wat er precies gebeurt.

Welke authenticatie gebruikt de bedrijfsdata API?

Beveiligde endpoints gebruiken een API-key in de X-API-Key-header. Een demo- of productiesleutel hoort nooit in browsercode te staan.

Geeft resolve altijd één bedrijf terug?

Nee. Het antwoord kan verified, probable, ambiguous of unmatched zijn en bevat maximaal vijf kandidaten. Bij twijfel hoort de aanroepende applicatie een keuze of review te vragen.

Kan ik ook een CSV verwerken?

Ja. De repair-jobroute accepteert een UTF-8 CSV van maximaal 10 MB en 500 records, met een unieke external_id per rij.

Begin met echte input

Toets Bedrijfsbron eerst op een afgebakende dataset.

Beschrijf je bronbestand, gewenste velden en beslisregels. Dan kan de pilot worden ingericht zonder directe writeback naar je ERP of CRM.

Bespreek je dataset