{ "openapi": "3.1.0", "info": { "title": "RDW API suite", "version": "0.0.1", "description": "De RDW API suite biedt endpoints om voertuig- en kentekeninformatie op te vragen. Controleer de geldigheid van kentekens en verkrijg gedetailleerde voertuiggegevens.\n\n## Authentication\n\nAll API endpoints require authentication. Include your API key in every request using **one** of the following methods:\n\n**Option 1 \u2014 X-Api-Key header (recommended)**\n```\nX-Api-Key: ga_live_xxxxxxxxxxxxxxxxxxxx\n```\n\n**Option 2 \u2014 Bearer token**\n```\nAuthorization: Bearer ga_live_xxxxxxxxxxxxxxxxxxxx\n```\n\nYou can generate and manage API keys in your [dashboard](https://getapi.nl/dashboard).\n\n## AI & Agent Payments (x402)\n\nSome endpoints support direct payments for AI agents via the **x402** protocol (https://www.x402.org).\nNo API key or account is needed. Send a normal request without key;\nthe server will respond with **HTTP 402** and a `PAYMENT-REQUIRED` header:\n\n```\nPAYMENT-REQUIRED: \n```\n\nThis base64 string contains, among other things, `network`, `asset`, `amount`, and `payTo`. \nYour agent signs an EIP-3009 *transferWithAuthorization* for the specified `amount` of USDC to that `payTo` address, \nencodes the signature as base64, and resubmits the request with:\n\n```\nPAYMENT-SIGNATURE: \n```\n\nThe server verifies the signature via a facilitator, provides the data, and settles the payment on-chain. \nThe success response includes a `PAYMENT-RESPONSE` header containing the transaction information. \nA one-time `nonce` prevents replay attacks. Payments are made in USDC on **Base**; \nthe price is determined by the `credit_cost` of the endpoint.", "contact": { "email": "info@wdnoord.nl" }, "x-guidance": "GetAPI.nl is een Nederlandse API-platform voor lookups en validaties (postcode,\nadres, kenteken, BTW, e-mail, KVK, IBAN, energiemaatwerk, overheidsdata). Elke\nendpoint accepteert een API key via de X-Api-Key header of Authorization:\nBearer .\n\nSommige endpoints zijn ook direct betaalbaar voor AI-agents via het x402-protocol\n(https://www.x402.org) zonder account of API key: stuur een verzoek zonder key,\nde server antwoordt met HTTP 402 en een PAYMENT-REQUIRED header (base64 JSON met\nnetwork, asset, amount, payTo). Teken daarna een EIP-3009 transferWithAuthorization\nvoor het gevraagde bedrag in USDC op Base en hertrail met een PAYMENT-SIGNATURE\nheader. De server verifieert, levert de data en settleert on-chain.\n\nTips voor agents:\n- Lees eerst de PAYMENT-REQUIRED header van een 402-antwoord; die is leidend.\n- Geef altijd de exact door de server gevraagde parameters mee.\n- Een endpoint met een \"x-payment-info\" blok vereist betaling voor gebruik." }, "servers": [ { "url": "https://api.getapi.nl", "description": "GetAPI" } ], "security": [ { "ApiKeyAuth": [] }, { "BearerAuth": [] }, { "ApiKeyAuth": [] }, { "BearerAuth": [] } ], "paths": { "/v1/rdw/vehicle": { "get": { "operationId": "rdw.vehicle", "description": "Returns vehicle registration data from the RDW Basisregistratie Voertuigen,\nenriched with fuel + emission information, a national milieuzone compliance\nflag, and a wide range of extended fields: catalogusprijs, dimensions,\nweight limits, body type, axle data and EV-specific specs (range, consumption,\ncontinuous power). Results are cached for 24 hours.\n\nNaast de gesubseteerde velden bevat de response het blok `rdw` met de\nvolledige bronrijen van alle vier RDW Open Data-datasets (Kenteken\nVoertuigen, Brandstof, Carrosserie, Assen) \u2014 g\u00e9\u00e9n veld wordt weggelaten.\nKolommen die RDW voor een voertuig leeg laat, zijn `null`.\n\nRDW registreert brandstof met 1 rij per brandstof (gesorteerd op\n`brandstof_volgnummer`). `fuel_type` is de primaire brandstof (volgnummer 1);\n`fuel_types` bevat alle geregistreerde brandstoffen en `hybrid` is `true`\nzodra er meer dan \u00e9\u00e9n brandstof is (bv. Benzine + Elektriciteit). Zo is een\nhybride auto te onderscheiden van een pure fossiel- of EV-auto.\n\nThe `allowed_in_green_zones` flag is derived from the emission class and fuel type\nusing Dutch national milieuzone standards (2024\u20132025):\n\n\u2014 Electric / hydrogen / CNG: always allowed\n\n\u2014 Petrol (any Euro class): allowed\n\n\u2014 Diesel Euro 6+: allowed\n\n\u2014 Diesel Euro 5 and below: not allowed\n\n\u2014 Unknown fuel or emission class: `null`\n\nFor a cheaper, smaller response with only the core vehicle fields, see the\n`vehicle-lite` endpoint.", "summary": "Vehicle lookup by Dutch license plate (kenteken) \u2014 Pro / extended response", "tags": [ "RDW", "Vehicle" ], "parameters": [ { "name": "license_plate", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9\\-\\s]{2,7}[A-Za-z0-9]$", "minLength": 4, "maxLength": 9 } } ], "responses": { "200": { "description": "Vehicle found (extended response)", "content": { "application/json": { "schema": { "type": "object", "examples": [ { "found": true, "license_plate": "1-SPV-45", "vehicle": { "brand": "Renault", "model": "Clio", "color": "Wit", "fuel_type": "Diesel", "fuel_types": [ "Diesel" ], "hybrid": false, "mass_empty": 1096, "power_kw": 66, "top_speed_kmh": null, "registration_date": "2025-06-02", "first_admission_date": "2013-11-27", "vehicle_type": "Personenauto", "seats": 5, "doors": 4, "wheels": 4, "length_cm": 427, "wheelbase_cm": 259, "mass_roadworthy_kg": 1196, "max_mass_kg": 1711, "towing_capacity_braked_kg": 1200, "towing_capacity_unbraked_kg": 595, "catalog_price_eur": 19480, "eu_category": "M1", "type_approval_number": "e2*2001/116*0327*57", "body_type": "Stationwagen", "body_code": "AC", "axle_count": 2, "driven_axles": [] }, "compliance": { "apk_expiry_date": "2027-07-06", "tachograph_expiry_date": null, "emission_class": 5, "allowed_in_green_zones": false, "transfer_possible": true, "recall_active": false, "export_indicator": false, "taxi": false, "liability_insured": true, "last_odometer_report": "Logisch" }, "rdw": { "vehicle": { "kenteken": "1SPV45", "voertuigsoort": "Personenauto", "merk": "RENAULT", "handelsbenaming": "CLIO", "vervaldatum_apk": "20270706", "datum_tenaamstelling": "20250602", "bruto_bpm": "729", "inrichting": "stationwagen", "aantal_zitplaatsen": "5", "eerste_kleur": "WIT", "tweede_kleur": "Niet geregistreerd", "aantal_cilinders": "4", "cilinderinhoud": "1461", "massa_ledig_voertuig": "1096", "toegestane_maximum_massa_voertuig": "1711", "massa_rijklaar": "1196", "maximum_massa_trekken_ongeremd": "595", "maximum_trekken_massa_geremd": "1200", "datum_eerste_toelating": "20131127", "datum_eerste_tenaamstelling_in_nederland": "20131127", "wacht_op_keuren": "Geen verstrekking in Open Data", "catalogusprijs": "19480", "wam_verzekerd": "Ja", "maximale_constructiesnelheid": null, "laadvermogen": null, "oplegger_geremd": null, "aanhangwagen_autonoom_geremd": null, "aanhangwagen_middenas_geremd": null, "aantal_staanplaatsen": null, "aantal_deuren": "4", "aantal_wielen": "4", "afstand_hart_koppeling_tot_achterzijde_voertuig": null, "afstand_voorzijde_voertuig_tot_hart_koppeling": null, "afwijkende_maximum_snelheid": null, "lengte": "427", "breedte": null, "europese_voertuigcategorie": "M1", "europese_voertuigcategorie_toevoeging": null, "europese_uitvoeringcategorie_toevoeging": null, "plaats_chassisnummer": "r. in kofferruimte by reservewiel", "technische_max_massa_voertuig": "1711", "type": "R", "type_gasinstallatie": null, "typegoedkeuringsnummer": "e2*2001/116*0327*57", "variant": "7RJL", "uitvoering": "7RJL0H", "volgnummer_wijziging_eu_typegoedkeuring": "0", "vermogen_massarijklaar": "0.06", "wielbasis": "259", "export_indicator": "Nee", "openstaande_terugroepactie_indicator": "Nee", "vervaldatum_tachograaf": null, "taxi_indicator": "Nee", "maximum_massa_samenstelling": "2611", "aantal_rolstoelplaatsen": null, "maximum_ondersteunende_snelheid": null, "jaar_laatste_registratie_tellerstand": "2026", "tellerstandoordeel": "Logisch", "code_toelichting_tellerstandoordeel": "00", "tenaamstellen_mogelijk": "Ja", "vervaldatum_apk_dt": "2027-07-06T00:00:00.000", "datum_tenaamstelling_dt": "2025-06-02T00:00:00.000", "datum_eerste_toelating_dt": "2013-11-27T00:00:00.000", "datum_eerste_tenaamstelling_in_nederland_dt": "2013-11-27T00:00:00.000", "vervaldatum_tachograaf_dt": null, "maximum_last_onder_de_vooras_sen_tezamen_koppeling": null, "type_remsysteem_voertuig_code": null, "rupsonderstelconfiguratiecode": null, "wielbasis_voertuig_minimum": null, "wielbasis_voertuig_maximum": null, "lengte_voertuig_minimum": null, "lengte_voertuig_maximum": null, "breedte_voertuig_minimum": null, "breedte_voertuig_maximum": null, "hoogte_voertuig": null, "hoogte_voertuig_minimum": null, "hoogte_voertuig_maximum": null, "massa_bedrijfsklaar_minimaal": null, "massa_bedrijfsklaar_maximaal": null, "technisch_toelaatbaar_massa_koppelpunt": null, "maximum_massa_technisch_maximaal": null, "maximum_massa_technisch_minimaal": null, "subcategorie_nederland": null, "verticale_belasting_koppelpunt_getrokken_voertuig": null, "zuinigheidsclassificatie": "A", "registratie_datum_goedkeuring_afschrijvingsmoment_bpm": null, "registratie_datum_goedkeuring_afschrijvingsmoment_bpm_dt": null, "gem_lading_wrde": null, "aerodyn_voorz": null, "massa_alt_aandr": null, "verl_cab_ind": null, "aantal_passagiers_zitplaatsen_wettelijk": null, "aanwijzingsnummer": null, "api_gekentekende_voertuigen_assen": "https://opendata.rdw.nl/resource/3huj-srit.json", "api_gekentekende_voertuigen_brandstof": "https://opendata.rdw.nl/resource/8ys7-d773.json", "api_gekentekende_voertuigen_carrosserie": "https://opendata.rdw.nl/resource/vezc-m2t6.json", "api_gekentekende_voertuigen_carrosserie_specifiek": "https://opendata.rdw.nl/resource/jhie-znh9.json", "api_gekentekende_voertuigen_voertuigklasse": "https://opendata.rdw.nl/resource/kmfi-hrps.json" }, "fuel": [ { "kenteken": "1SPV45", "brandstof_volgnummer": "1", "brandstof_omschrijving": "Diesel", "brandstofverbruik_gecombineerd": "3.20", "co2_uitstoot_gecombineerd": "83", "co2_uitstoot_gewogen": null, "geluidsniveau_rijdend": null, "geluidsniveau_stationair": "81", "emissiecode_omschrijving": "5", "milieuklasse_eg_goedkeuring_licht": "715/2007*630/2012J", "milieuklasse_eg_goedkeuring_zwaar": null, "uitstoot_deeltjes_licht": "0.00015", "uitstoot_deeltjes_zwaar": null, "nettomaximumvermogen": "66.00", "nominaal_continu_maximumvermogen": null, "toerental_geluidsniveau": "3000", "emis_deeltjes_type1_wltp": null, "emissie_co2_gecombineerd_wltp": null, "emis_co2_gewogen_gecombineerd_wltp": null, "brandstof_verbruik_gecombineerd_wltp": null, "brandstof_verbruik_gewogen_gecombineerd_wltp": null, "elektrisch_verbruik_enkel_elektrisch_wltp": null, "actie_radius_enkel_elektrisch_wltp": null, "elektrisch_verbruik_extern_opladen_wltp": null, "actie_radius_extern_opladen_wltp": null, "max_vermogen_15_minuten": null, "netto_max_vermogen_elektrisch": null, "klasse_hybride_elektrisch_voertuig": null, "opgegeven_maximum_snelheid": null, "uitlaatemissieniveau": "EURO 5 J", "co2_emissieklasse": null, "brandstofverbruik_gewogen_gecombineerd": null, "elektriciteitsverbruik_gewogen_gecombineerd": null, "actieradius_extern_oplaadbaar": null, "actieradius": null, "elektriciteitsverbruik_volledig_elektrisch": null } ], "body": [ { "kenteken": "1SPV45", "carrosserie_volgnummer": "1", "carrosserietype": "AC", "type_carrosserie_europese_omschrijving": "Stationwagen" } ], "axles": [ { "kenteken": "1SPV45", "as_nummer": "1", "aantal_assen": "2", "aangedreven_as": null, "hefas": null, "plaatscode_as": null, "spoorbreedte": "151", "weggedrag_code": null, "wettelijk_toegestane_maximum_aslast": "920", "technisch_toegestane_maximum_aslast": "920", "geremde_as_indicator": null, "afstand_tot_volgende_as_voertuig": null, "afstand_tot_volgende_as_voertuig_minimum": null, "afstand_tot_volgende_as_voertuig_maximum": null, "maximum_last_as_technisch_maximum": null, "maximum_last_as_technisch_minimum": null }, { "kenteken": "1SPV45", "as_nummer": "2", "aantal_assen": "2", "aangedreven_as": null, "hefas": null, "plaatscode_as": null, "spoorbreedte": "151", "weggedrag_code": null, "wettelijk_toegestane_maximum_aslast": "885", "technisch_toegestane_maximum_aslast": "885", "geremde_as_indicator": null, "afstand_tot_volgende_as_voertuig": null, "afstand_tot_volgende_as_voertuig_minimum": null, "afstand_tot_volgende_as_voertuig_maximum": null, "maximum_last_as_technisch_maximum": null, "maximum_last_as_technisch_minimum": null } ] } } ], "properties": { "found": { "type": "boolean" }, "license_plate": { "type": "string" }, "vehicle": { "type": "object", "additionalProperties": [] }, "compliance": { "type": "object", "additionalProperties": [] }, "rdw": { "type": "object", "properties": { "vehicle": { "type": "object", "additionalProperties": [] }, "fuel": { "type": "array", "items": { "type": "object", "additionalProperties": [] } }, "body": { "type": "array", "items": { "type": "object", "additionalProperties": [] } }, "axles": { "type": "array", "items": { "type": "object", "additionalProperties": [] } } }, "required": [ "vehicle", "fuel", "body", "axles" ] } }, "required": [ "found", "license_plate", "vehicle", "compliance", "rdw" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" }, "404": { "description": "License plate not found in RDW", "content": { "application/json": { "schema": { "type": "object", "examples": [ { "found": false, "license_plate": "XX-000-X", "vehicle": null, "compliance": null, "error": null } ], "properties": { "found": { "type": "boolean" }, "license_plate": { "type": "string" }, "vehicle": { "type": "null" }, "compliance": { "type": "null" }, "error": { "type": "null" } }, "required": [ "found", "license_plate", "vehicle", "compliance", "error" ] } } } }, "503": { "description": "External service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "examples": [ { "found": null, "license_plate": "AB-123-C", "vehicle": null, "compliance": null, "error": "upstream_unavailable" } ], "properties": { "found": { "type": "null" }, "license_plate": { "type": "string" }, "vehicle": { "type": "null" }, "compliance": { "type": "null" }, "error": { "type": "string" } }, "required": [ "found", "license_plate", "vehicle", "compliance", "error" ] } } } }, "402": { "description": "Payment Required" } }, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] } } }, "/v1/rdw/vehicle-lite": { "get": { "operationId": "rdw.vehicle-lite", "description": "Returns the core vehicle fields (merk, model, kleur, brandstof, vermogen,\nAPK-status, milieuzone-vlag) from the RDW Basisregistratie Voertuigen.\nResults are cached for 24 hours.\n\nFor a wider response including catalogusprijs, dimensions, body type,\naxle data and EV-specs, use the `vehicle` (Pro) endpoint.", "summary": "Lightweight vehicle lookup by Dutch license plate (kenteken)", "tags": [ "RDW", "VehicleLite" ], "parameters": [ { "name": "license_plate", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9\\-\\s]{2,7}[A-Za-z0-9]$", "minLength": 4, "maxLength": 9 } } ], "responses": { "200": { "description": "Vehicle found (lite response)", "content": { "application/json": { "schema": { "type": "object", "examples": [ { "found": true, "license_plate": "AB-123-C", "vehicle": { "brand": "Tesla", "model": "Model 3", "color": "Wit", "fuel_type": "Elektriciteit", "mass_empty": 1822, "power_kw": 239, "top_speed_kmh": 225, "registration_date": "2021-03-15", "first_admission_date": "2021-03-01" }, "compliance": { "apk_expiry_date": "2027-04-01", "tachograph_expiry_date": null, "emission_class": 6, "allowed_in_green_zones": true, "transfer_possible": true, "recall_active": false, "export_indicator": false, "taxi": false, "liability_insured": true, "last_odometer_report": "Logisch" } } ], "properties": { "found": { "type": [ "boolean", "null" ] }, "license_plate": { "type": [ "string", "null" ] }, "vehicle": { "type": [ "object", "null" ], "additionalProperties": [] }, "compliance": { "type": [ "object", "null" ], "additionalProperties": [] }, "error": { "type": [ "string", "null" ] } }, "required": [ "found", "license_plate", "vehicle", "compliance", "error" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" }, "404": { "description": "License plate not found in RDW", "content": { "application/json": { "schema": { "type": "object", "examples": [ { "found": false, "license_plate": "XX-000-X", "vehicle": null, "compliance": null, "error": null } ], "properties": { "found": { "type": "boolean" }, "license_plate": { "type": "string" }, "vehicle": { "type": "null" }, "compliance": { "type": "null" }, "error": { "type": "null" } }, "required": [ "found", "license_plate", "vehicle", "compliance", "error" ] } } } }, "503": { "description": "RDW Open Data service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "examples": [ { "found": null, "license_plate": "AB-123-C", "vehicle": null, "compliance": null, "error": "upstream_unavailable" } ], "properties": { "found": { "type": "null" }, "license_plate": { "type": "string" }, "vehicle": { "type": "null" }, "compliance": { "type": "null" }, "error": { "type": "string" } }, "required": [ "found", "license_plate", "vehicle", "compliance", "error" ] } } } } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-Api-Key" }, "BearerAuth": { "type": "http", "scheme": "bearer" } }, "responses": { "ValidationException": { "description": "Validation error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "description": "Errors overview." }, "errors": { "type": "object", "description": "A detailed description of each field that failed validation.", "additionalProperties": { "type": "array", "items": { "type": "string" } } } }, "required": [ "message", "errors" ] } } } } } } }