Plate-op: publiek voertuigrapport op kenteken .well-known API

{"openapi":"3.1.0","info":{"title":"Plate-op: publiek voertuigrapport op kenteken","version":"1.0.0","description":"Het gratis deel van een Plate-op-aankooprapport: registergegevens, keuringen, tellerstandoordeel en terugroepacties voor één voertuig, als JSON met bron en peildatum per feit. Geen persoonsgegevens, geen betaald rapportonderdeel (aankoopscore, bekende modelproblemen, prijsoordeel, checklist, verkopersvragen, onderhandelingsadvies). Licentie: CC BY 4.0. Vermeld de bron en de peildatum bij hergebruik.","contact":{"url":"https://plateop.com"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://nederland.plateop.com","description":"nl (nederland)"},{"url":"https://israel.plateop.com","description":"il (israel)"},{"url":"https://island.plateop.com","description":"is (island)"},{"url":"https://uk.plateop.com","description":"gb (uk)"},{"url":"https://danmark.plateop.com","description":"dk (danmark)"}],"paths":{"/api/rapport/kenteken/{kenteken}":{"get":{"operationId":"haalPubliekRapportOpKenteken","summary":"Gratis voertuigrapport op kenteken","description":"Registergegevens, keuringen, tellerstandoordeel en terugroepacties (voertuigspecifiek waar het register dat levert, anders op modelniveau via de EU Safety Gate). Ondersteunde markten: nl, gb, il, is, dk (kentekenregisters), elk via een eigen land-subdomein, zie `servers`.","parameters":[{"name":"kenteken","in":"path","required":true,"description":"Het kenteken, ruim geaccepteerd (streepjes, spaties en kleine letters worden genegeerd) en per markt gevalideerd/genormaliseerd.","schema":{"type":"string"}},{"name":"taal","in":"query","required":false,"description":"Taal van de leesbare teksten in het antwoord (bijv. `beperkingen`, `citeerwijze`). Standaard: de standaardtaal van het land-subdomein.","schema":{"type":"string"}}],"responses":{"200":{"description":"Gratis rapportdeel voor dit kenteken.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RapportKentekenResponse"}}}},"400":{"description":"Ongeldig kenteken voor deze markt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fout"}}}},"404":{"description":"Kenteken niet gevonden in het register, of deze markt heeft geen kentekenregister.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fout"}}}},"429":{"description":"Rate limiet overschreden. De `Retry-After`-header geeft het aantal seconden tot een nieuwe poging.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconden tot een nieuwe poging."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fout"}}}},"502":{"description":"De officiële bron voor deze markt is momenteel niet bereikbaar.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fout"}}}},"503":{"description":"Dit endpoint is tijdelijk uitgeschakeld voor deze markt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fout"}}}}}}}},"components":{"schemas":{"RapportKentekenResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kenteken":{"type":"string"},"markt":{"type":"string"},"taal":{"type":"string"},"opgehaaldOp":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"voertuig":{"type":"object","properties":{"merk":{"type":"string"},"model":{"type":"string"},"bouwjaar":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"brandstof":{"type":"string"},"kleur":{"type":"string"},"carrosserie":{"type":"string"},"handelsbenaming":{"type":"string"},"cilinderinhoudCc":{"type":"number"},"vermogenKw":{"type":"number"},"motorcode":{"type":"string"},"uitvoeringFabrikant":{"type":"string"},"bron":{"type":"object","properties":{"naam":{"type":"string","minLength":1},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["naam","url"],"additionalProperties":false},"peildatum":{"type":"string","minLength":4}},"required":["merk","model","bron","peildatum"],"additionalProperties":false},"kernfeiten":{"type":"object","properties":{"catalogusprijs":{"type":"number"},"vermogenKw":{"type":"number"},"cilinderinhoudCc":{"type":"number"},"datumEersteToelating":{"type":"string"},"datumLaatsteTenaamstelling":{"type":"string"},"co2UitstootGkm":{"type":"number"},"emissieklasse":{"type":"string"},"verbruikL100km":{"type":"number"},"jaarLaatsteTellerregistratie":{"type":"number"},"datumLaatsteKeuring":{"type":"string"},"aandrijving":{"type":"string","enum":["voor","achter","vierwiel"]},"bron":{"type":"object","properties":{"naam":{"type":"string","minLength":1},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["naam","url"],"additionalProperties":false},"peildatum":{"type":"string","minLength":4}},"required":["bron","peildatum"],"additionalProperties":false},"apkVervaldatum":{"anyOf":[{"type":"object","properties":{"datum":{"type":"string"},"bron":{"type":"object","properties":{"naam":{"type":"string","minLength":1},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["naam","url"],"additionalProperties":false},"peildatum":{"type":"string","minLength":4}},"required":["datum","bron","peildatum"],"additionalProperties":false},{"type":"null"}]},"tellerstandOordeel":{"anyOf":[{"type":"object","properties":{"oordeel":{"type":"string","enum":["Logisch","Onlogisch"]},"toelichtingCode":{"type":"string"},"bron":{"type":"object","properties":{"naam":{"type":"string","minLength":1},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["naam","url"],"additionalProperties":false},"peildatum":{"type":"string","minLength":4}},"required":["oordeel","bron","peildatum"],"additionalProperties":false},{"type":"null"}]},"verzekering":{"anyOf":[{"type":"object","properties":{"verzekerd":{"type":"boolean"},"bron":{"type":"object","properties":{"naam":{"type":"string","minLength":1},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["naam","url"],"additionalProperties":false},"peildatum":{"type":"string","minLength":4}},"required":["verzekerd","bron","peildatum"],"additionalProperties":false},{"type":"null"}]},"keuringen":{"type":"array","items":{"type":"object","properties":{"datum":{"anyOf":[{"type":"string"},{"type":"null"}]},"omschrijving":{"type":"string"},"soort":{"type":"string","enum":["gebrek","adviespunt"]},"aantal":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"bron":{"type":"object","properties":{"naam":{"type":"string","minLength":1},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["naam","url"],"additionalProperties":false},"peildatum":{"type":"string","minLength":4}},"required":["datum","omschrijving","soort","aantal","bron","peildatum"],"additionalProperties":false}},"terugroepVoertuig":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["open","hersteld","onbekend"]},"aantalActies":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"bron":{"type":"object","properties":{"naam":{"type":"string","minLength":1},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["naam","url"],"additionalProperties":false},"peildatum":{"type":"string","minLength":4}},"required":["status","bron","peildatum"],"additionalProperties":false},{"type":"null"}]},"terugroepModelniveau":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["model","merkbreed"]},"aantal":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"bron":{"type":"object","properties":{"naam":{"type":"string","minLength":1},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["naam","url"],"additionalProperties":false},"peildatum":{"type":"string","minLength":4}},"required":["status","aantal","bron","peildatum"],"additionalProperties":false},{"type":"null"}]},"beperkingen":{"type":"array","items":{"type":"string"}},"volledigRapport":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"prijs":{"type":"object","properties":{"bedrag":{"type":"number","exclusiveMinimum":0},"valuta":{"type":"string","minLength":3,"maxLength":3}},"required":["bedrag","valuta"],"additionalProperties":false}},"required":["url","prijs"],"additionalProperties":false},"licentie":{"type":"string","const":"CC BY 4.0"},"citeerwijze":{"type":"string"}},"required":["kenteken","markt","taal","opgehaaldOp","voertuig","kernfeiten","apkVervaldatum","tellerstandOordeel","verzekering","keuringen","terugroepVoertuig","terugroepModelniveau","beperkingen","volledigRapport","licentie","citeerwijze"],"additionalProperties":false},"Fout":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fout":{"type":"string"},"bericht":{"type":"string"}},"required":["fout","bericht"],"additionalProperties":false}}}}