CarfindVehicle Risk Intelligence Platform

Carfind API v1

Koppel Carfind aan uw DMS, CRM, veiling- of remarketingsoftware. De volledige specificatie staat in OpenAPI 3.1-formaat (importeerbaar in Postman, Insomnia of uw codegenerator).

Authenticatie

Maak een API-sleutel aan in het portaal (API-sleutels, enkel beheerders). Stuur hem mee in elke aanroep:

Authorization: Bearer cf_live_xxxxxxxxxxxx_…

Sleutels hebben rechten (checks:write, checks:read, signals:write, signals:read), een vervaldatum en kunnen op elk moment worden ingetrokken. Bewaar ze als geheim (nooit in front-end code of versiebeheer).

Eén VIN controleren

POST https://carfind.be/api/v1/checks
Content-Type: application/json

{ "vin": "WVWZZZ1KZAW000001", "purpose": "PURCHASE", "reference": "STOCK-4411" }
200 OK
{
  "id": "0192…",
  "vin": "WVWZZZ1KZAW000001",
  "result": "NO_SIGNAL",            // NO_SIGNAL | ACTIVE_SIGNAL | MANUAL_VERIFICATION | INVALID_VIN
  "title": "Geen Carfind-signaal",
  "categories": [],
  "next_step": "…",
  "case_refs": [],
  "checked_at": "2026-10-06T09:12:44.120Z",
  "proof_hash": "9f2c…"
}

Doel (purpose) is verplicht: PURCHASE (Aankoop), TRADE_IN (Inruil), FINANCING (Financiering), SALE (Doorverkoop), AUCTION (Veiling / listing), STOCK_AUDIT (Stockcontrole).

Meerdere VIN's

POST https://carfind.be/api/v1/checks/batch
{ "purpose": "STOCK_AUDIT", "items": [ { "vin": "…", "reference": "A1" }, { "vin": "…" } ] }

Maximaal 100 items per aanroep. Het quotum wordt vooraf voor de hele batch gecontroleerd.

Leveranciers: signalen beheren

POST https://carfind.be/api/v1/signals
{ "vin": "…", "category": "NOT_RETURNED", "evidence_ref": "OPZEG-2026-118", "external_ref": "LC-99812", "authority_confirmed": true }

POST https://carfind.be/api/v1/signals/{id}/reconfirm
POST https://carfind.be/api/v1/signals/{id}/close   { "reason": "RECOVERED" }

Limieten & fouten

Goede praktijk