API voor gecertificeerde data

API met gecertificeerde voertuigdata voor ontwikkelaars

Integreer gecertificeerde, controleerbare voertuighistorie in uw applicatie via onze RESTful API. Afkomstig uit ruim 900 officiële registers en 1B+ geverifieerde registraties in 45+ landen, met een uptime-SLA van 99,95%.

https://api.autocertif.com/v1

Aan de slag Bekijk endpoints

Snel starten

Vraag uw API-sleutel aan

Meld u aan voor een gecertificeerd zakelijk account en genereer uw API-sleutel in het dashboard. Sandboxsleutels zijn beschikbaar om te testen, zonder verbruikskosten.

Doe uw eerste aanroep

Authenticeer met uw API-sleutel en certificaatsleutel en stuur uw eerste verzoek naar een willekeurig endpoint. Begin met het endpoint voor voertuigidentiteit voor een direct antwoord met bronvermelding.

Ontvang resultaten

Ontvang gestructureerde JSON met gecertificeerde voertuigdata, bronvermelding en een verificatietijdstempel bij elk veld. Verwerk, toon of archiveer de resultaten naar behoefte.

Authenticatie

Elk API-verzoek wordt geauthenticeerd met twee gegevens: een Bearer-token in de Authorization-header en uw X-Certificate-Key-header. Sleutels worden aangemaakt, vernieuwd en ingetrokken vanuit uw gecertificeerde zakelijke dashboard, met volledige toegangslogging voor compliance.

Voorbeeldverzoek

curl -X GET https://api.autocertif.com/v1/vehicles/WBA3A5G59DNP26082/identity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY" \
  -H "Content-Type: application/json"

Bewaar uw sleutels veilig! Zet uw API-sleutel of X-Certificate-Key nooit in code aan de clientzijde. Bewaar ze in omgevingsvariabelen en stuur uw aanroepen via een proxy aan de serverzijde, zodat uw inloggegevens en uw audittrail beschermd blijven.

Endpoints

De Certified Data API biedt vijf kernendpoints: een gecertificeerd rapport aanvragen, een certificaat ophalen, de certificeringsstatus volgen, bulkcertificeringen uitvoeren en een VIN-identiteit opzoeken. Elk certificaat draagt een fraudebestendig zegel, bronvermelding en een certified_at-tijdstempel.

POST/v1/certificates

Certificaat aanvragen

Vraag een gecertificeerd voertuigrapport aan op basis van een VIN of kenteken. Elk gegeven is herleidbaar tot de officiële bron, verzegeld en voorzien van een tijdstempel.

Parameters

Naam	Type	Verplicht	Omschrijving
`vin`	string	Voorwaardelijk	Voertuigidentificatienummer van 17 tekens. Verplicht tenzij license_plate is opgegeven.
`license_plate`	string	Voorwaardelijk	Kenteken. Verplicht tenzij vin is opgegeven.
`country`	string	Ja	ISO-landcode van de registratie, bijvoorbeeld FR
`depth`	string	Nee	Certificeringsdiepte: standard (standaardwaarde) of full

Voorbeeldverzoek

curl -X POST https://api.autocertif.com/v1/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vin": "WBA3A5G59DNP26082", "country": "FR", "depth": "full"}'

GET/v1/certificates/{certificate_id}

Certificaat ophalen

Haal een eerder uitgegeven certificaat op via de identificatie ervan, inclusief zegel, uitgevoerde controles en betrouwbaarheidsscore.

Parameters

Naam	Type	Verplicht	Omschrijving
`certificate_id`	string	Ja	Certificaat-identificatie die bij de aanvraag van het rapport is teruggegeven (padparameter)

Voorbeeldverzoek

curl -X GET https://api.autocertif.com/v1/certificates/cert_8f2a91 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY"

GET/v1/certificates/{certificate_id}/status

Certificaatstatus

Bekijk de verwerkings- en certificeringsstatus van een certificaat terwijl de officiële bronnen worden geverifieerd.

Parameters

Naam	Type	Verplicht	Omschrijving
`certificate_id`	string	Ja	Certificaat-identificatie die u wilt bekijken (padparameter)

Voorbeeldverzoek

curl -X GET https://api.autocertif.com/v1/certificates/cert_8f2a91/status \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY"

POST/v1/certificates/bulk

Bulkcertificaten

Dien in één aanroep een reeks identificaties ter certificering in. Elk certificaat wordt afzonderlijk verzegeld en kan afzonderlijk worden opgehaald of gevolgd.

Parameters

Naam	Type	Verplicht	Omschrijving
`identifiers`	array	Ja	Array met VIN- of kentekenstrings (max. 100 per verzoek)
`country`	string	Ja	ISO-landcode die op de hele batch wordt toegepast, bijvoorbeeld FR
`depth`	string	Nee	Certificeringsdiepte voor elk item: standard (standaardwaarde) of full

Voorbeeldverzoek

curl -X POST https://api.autocertif.com/v1/certificates/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identifiers": ["WBA3A5G59DNP26082", "WVWZZZ3CZWE123456"], "country": "FR", "depth": "full"}'

GET/v1/vehicles/{vin}/identity

Voertuigidentiteit

Decodeer een VIN tegen de officiële fabrikantenregisters en ontvang merk, model, bouwjaar en gecertificeerde specificaties, zonder een volledig certificaat uit te geven.

Parameters

Naam	Type	Verplicht	Omschrijving
`vin`	string	Ja	Voertuigidentificatienummer van 17 tekens (padparameter)
`include_specs`	boolean	Nee	Neem de volledige gecertificeerde technische specificaties op

Voorbeeldverzoek

curl -X GET https://api.autocertif.com/v1/vehicles/WBA3A5G59DNP26082/identity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY"

Responsformaat

Elk certificaat komt terug als een consistent JSON-object: een uniek certificate_id, een verificatiezegel, het gedecodeerde voertuig, de gecertificeerde controles, een betrouwbaarheidsscore en metadata die de context van het verzoek vastleggen.

JSON-respons

{
  "certificate_id": "cert_8f2a91",
  "vin": "WBA3A5G59DNP26082",
  "certified_at": "2026-03-12T10:04:00Z",
  "seal": {
    "id": "seal_3kf9",
    "valid": true
  },
  "vehicle": {
    "make": "BMW",
    "model": "320d",
    "year": 2019
  },
  "checks": {
    "mileage": {
      "value": 142350,
      "unit": "km",
      "verified": true
    },
    "accidents": 0,
    "theft": "none",
    "title": "clean"
  },
  "official_sources": 8200,
  "confidence_score": 9.1,
  "meta": {
    "country": "FR",
    "depth": "full"
  }
}

Responsvelden

certificate_idUnieke identificatie van het uitgegeven certificaat, met voorvoegsel cert_

vinHet gecertificeerde voertuigidentificatienummer

certified_atISO 8601-tijdstempel waarop het certificaat is verzegeld

sealFraudebestendig verificatiezegel, met zijn id (voorvoegsel seal_) en de vlag valid

vehicleGedecodeerde voertuigidentiteit: merk, model en bouwjaar

checks.mileageKilometerstand met eenheid en gecertificeerde verificatiestatus

checks.accidentsAantal gecertificeerde ongevalsregistraties

checks.theftDiefstalstatus, geverifieerd bij officiële politiedatabases: none of flagged

checks.titleJuridische status, gecertificeerd bij het officiële register: clean of branded

official_sourcesTotaal aantal officiële gegevensbronnen dat voor dit certificaat is gekruist

confidence_scoreBetrouwbaarheid van de certificering op een schaal van 0 tot 10

metaContext van het verzoek: land van registratie en certificeringsdiepte

Foutafhandeling

De API gebruikt de standaard HTTP-statuscodes. Elke fout geeft een beschrijvende melding terug plus een detailveld met een request-id, zodat debuggen en controleren eenvoudig blijft.

Code	Melding	Omschrijving
400	Bad Request	De body of de parameters van het verzoek zijn onjuist opgebouwd, of er ontbreken verplichte velden.
401	Unauthorized	De API-sleutel ontbreekt, is ongeldig of is ingetrokken.
403	Forbidden	De API-sleutel heeft geen rechten voor dit endpoint of deze resource.
404	Not Found	De gevraagde resource (certificaat, voertuig) is niet gevonden.
429	Too Many Requests	Aanvraaglimiet overschreden. Raadpleeg de X-Certificate-RateLimit-headers en probeer het na het resetvenster opnieuw.
500	Server Error	Er is een interne fout opgetreden. Probeer het verzoek opnieuw of neem contact op met support als het probleem aanhoudt.

Voorbeeld van een foutrespons

{
  "status": "error",
  "error": {
    "code": 401,
    "message": "Unauthorized",
    "detail": "The provided API key is invalid or has expired."
  }
}

Aanvraaglimieten

API-verzoeken worden begrensd per abonnementsniveau, elk gedekt door een contractuele SLA. Het actuele verbruik van uw limiet staat in de responseheaders van elke aanroep.

Starter

Verzoeken / min

Verzoeken / dag

1,000

Gelijktijdig

Groei

Verzoeken / min

300

Verzoeken / dag

10,000

Gelijktijdig

Enterprise

Verzoeken / min

1,000+

Verzoeken / dag

Onbeperkt

Gelijktijdig

100+

Headers voor aanvraaglimieten

Elke API-respons bevat headers waarmee u uw verbruik in realtime kunt afzetten tegen uw SLA.

X-Certificate-RateLimit-Limit, maximumaantal toegestane verzoeken per venster
X-Certificate-RateLimit-Remaining, resterende verzoeken in het huidige venster
X-Certificate-RateLimit-Reset, unix-tijdstempel waarop de limiet wordt gereset

Webhooks

Ontvang ondertekende meldingen in realtime zodra een certificaat wordt uitgegeven of er belangrijke gebeurtenissen op uw account plaatsvinden. Webhook-endpoints stelt u in en verifieert u vanuit uw dashboard.

Ondersteunde gebeurtenissen

certificate.issued, een certificaat is verzegeld en met succes uitgegeven
certificate.failed, de certificering kon niet worden afgerond
bulk.completed, alle certificaten in een batch zijn verzegeld
bulk.partial, een deel van de certificaten in een batch is verzegeld
subscription.usage, de aanvraaglimiet of de quotumdrempel komt in zicht

Webhookbeveiliging

Elke webhookpayload wordt ondertekend met HMAC-SHA256 en uw webhooksecret. Controleer de X-Certificate-Signature-header om echtheid en integriteit te bevestigen voordat u de payload verwerkt.

Voorbeeld van een webhookpayload

{
  "event": "certificate.issued",
  "timestamp": "2026-03-12T10:04:00Z",
  "data": {
    "certificate_id": "cert_8f2a91",
    "vin": "WBA3A5G59DNP26082",
    "status": "certified",
    "seal": {
      "id": "seal_3kf9",
      "valid": true
    },
    "certificate_url": "https://api.autocertif.com/v1/certificates/cert_8f2a91"
  }
}

Klaar om te bouwen op gecertificeerde data?

Maak uw gecertificeerde ontwikkelaarsaccount aan en integreer vandaag nog officiële voertuigdata met SLA-garantie in uw applicaties.

Vraag uw API-sleutel aan Neem contact op