{ "openapi": "3.1.0", "info": { "title": "KentekenFeed API", "version": "1", "description": "Dutch RDW vehicle data: vehicle lookups, analytics over the whole register, and a mutation feed with snapshots and mutation files.\n\n- Send your API key as `Authorization: Bearer kf_live_…` or `X-Api-Key: kf_live_…`. Never in the URL.\n- Every error is `{\"error\": {\"code\", \"message\", \"request_id\", \"details?\"}}`; `code` is stable, `message` is not.\n- Timestamps are ISO-8601 in UTC (`2026-11-03T08:07:10Z`). Amounts are numbers in euros: a vehicle carries the unit in the field name (`catalog_price_eur`), analytics does not (`catalog_price`).\n- Every response has an `X-Request-Id` header." }, "servers": [ { "url": "https://api.kentekenfeed.nl/api/v1" } ], "tags": [ { "name": "vehicles" }, { "name": "analytics", "description": "Counts, breakdowns and metrics over the whole register (API key with `vehicles:read`, plan with analytics)." }, { "name": "feed", "description": "Mutation feed, snapshots and mutation files (API key with `mutations:read`)." } ], "security": [], "paths": { "/vehicles/{registration}": { "get": { "tags": [ "vehicles" ], "summary": "One vehicle (`vehicles:read`, plan with the vehicle API). Billed only on 200.", "description": "The `vehicle.v1` record. Choose the `view`\n(compact by default, full, or raw RDW names) and, for compact and full, the sections to `include`.\nInvalid parameters are `422 validation_failed` and are not billed.", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "name": "registration", "in": "path", "required": true, "description": "Six letters and digits, separators allowed (AB-123-C).", "schema": { "type": "string" } }, { "name": "view", "in": "query", "description": "`compact` (default) leaves out fields RDW has no value for and empty collections; `full` returns every field (null when unavailable) and every collection; `raw` returns the typed values under RDW dataset and column names.", "schema": { "type": "string", "enum": [ "compact", "full", "raw" ], "default": "compact" } }, { "name": "include", "in": "query", "description": "Comma-separated sections to return (`vehicle`, `technical`, `environment`, `status`, `inspections`, `history`); `registration` and `metadata` are always returned. Unknown names are a 422. Not with `view=raw`.", "schema": { "type": "string" }, "examples": { "technical": { "value": "technical,environment" } } } ], "responses": { "200": { "description": "The vehicle, as `{data}` with the response metadata inside `data`.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/VehicleResponse" }, { "$ref": "#/components/schemas/VehicleRawResponse" } ] } } } }, "default": { "$ref": "#/components/responses/Error" } } } }, "/datasets": { "get": { "tags": [ "vehicles" ], "summary": "Every dataset with its public name, key, rows, version and freshness (any key; vehicle API or feed plan)", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Datasets.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/Freshness" }, { "type": "object", "required": [ "name", "source_dataset", "role", "description", "key", "rows", "version" ], "properties": { "name": { "type": "string" }, "source_dataset": { "type": "string" }, "role": { "type": "string", "enum": [ "vehicle", "vehicle_child", "reference" ] }, "description": { "type": "string" }, "key": { "type": "array", "items": { "type": "string" } }, "rows": { "type": [ "integer", "null" ] }, "version": { "type": [ "string", "null" ] } } } ] } }, "meta": { "type": "object", "required": [ "schema_version", "data_version" ], "properties": { "schema_version": { "type": "string" }, "data_version": { "type": "string" } } } } } } } }, "default": { "$ref": "#/components/responses/Error" } } } }, "/analytics/fields": { "get": { "tags": [ "analytics" ], "summary": "The fields analytics can filter, group and measure, the subjects and the limits (not billed)", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "The analytics vocabulary.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "object", "required": [ "subjects", "fields", "limits" ], "properties": { "subjects": { "type": "array", "items": { "type": "object", "required": [ "name", "description", "counts", "default_group_by" ], "properties": { "name": { "type": "string", "enum": [ "vehicles", "defects" ] }, "description": { "type": "string" }, "counts": { "type": "string", "enum": [ "vehicles", "defects" ] }, "default_group_by": { "type": [ "string", "null" ] } } } }, "fields": { "type": "array", "items": { "type": "object", "required": [ "name", "dataset", "type", "kind", "description", "filter", "group_by", "metrics" ], "properties": { "name": { "type": "string", "examples": [ "make", "fuels.fuel" ] }, "dataset": { "type": "string" }, "type": { "type": "string", "enum": [ "string", "integer", "number", "date", "time", "boolean" ] }, "kind": { "type": "string", "enum": [ "dimension", "date", "metric" ] }, "description": { "type": "string" }, "filter": { "type": "string", "enum": [ "values", "range" ] }, "group_by": { "type": "array", "items": { "type": [ "string", "null" ], "enum": [ "year", "month", null ] }, "description": "[null]: group by value; year/month: the intervals a date takes; []: cannot be grouped by." }, "metrics": { "type": "array", "items": { "type": "string", "enum": [ "avg", "min", "max", "sum", "median" ] } } } } }, "limits": { "type": "object", "required": [ "group_levels", "groups_per_level", "default_groups_per_level", "filter_values", "metrics", "month_groups" ], "properties": { "group_levels": { "type": "integer" }, "groups_per_level": { "type": "integer" }, "default_groups_per_level": { "type": "integer" }, "filter_values": { "type": "integer" }, "metrics": { "type": "integer" }, "month_groups": { "type": "integer" } } } } }, "meta": { "type": "object", "required": [ "schema_version" ], "properties": { "schema_version": { "const": "analytics.v1" } } } } } } } }, "default": { "$ref": "#/components/responses/Error" } } } }, "/analytics/vehicles": { "get": { "tags": [ "analytics" ], "summary": "Count vehicles in the register, grouped and measured (`vehicles:read`, plan with analytics). One analytics query per 200.", "description": "Counts every vehicle in RDW's open register, exported and deregistered ones included\n(`filter[registration_allowed]=true` for vehicles that can be on the road). A child dataset\nfield (`fuels.fuel`) filters on and groups by the vehicle's rows of that dataset, and `count`\nis still vehicles. Answers are cached until the next sync; a cached answer is still billed.", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "$ref": "#/components/parameters/AnalyticsFilter" }, { "$ref": "#/components/parameters/AnalyticsGroupBy" }, { "$ref": "#/components/parameters/AnalyticsMetrics" }, { "$ref": "#/components/parameters/AnalyticsLimit" } ], "responses": { "200": { "$ref": "#/components/responses/Analytics" }, "default": { "$ref": "#/components/responses/Error" } } } }, "/analytics/defects": { "get": { "tags": [ "analytics" ], "summary": "Count defects found at inspections, by defect code unless grouped otherwise (`vehicles:read`, plan with analytics). One analytics query per 200.", "description": "`count` is defect findings (one per defect row of an inspection report) and `vehicles` the\ndistinct vehicles they were found on. `defects.*` filters select the findings counted;\nvehicle filters select the vehicles. Defect code groups carry the description and article\nof the code's latest catalogue version.", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "$ref": "#/components/parameters/AnalyticsFilter" }, { "$ref": "#/components/parameters/AnalyticsGroupBy" }, { "$ref": "#/components/parameters/AnalyticsMetrics" }, { "$ref": "#/components/parameters/AnalyticsLimit" } ], "responses": { "200": { "$ref": "#/components/responses/Analytics" }, "default": { "$ref": "#/components/responses/Error" } } } }, "/mutations": { "get": { "tags": [ "feed" ], "summary": "`mutation.v1` records in position order (`mutations:read`, plan with the feed). Not billed.", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "name": "after", "in": "query", "description": "A cursor from this API (next_cursor, checkpoint, a batch or snapshot).", "schema": { "type": "string" } }, { "name": "registration", "in": "query", "schema": { "type": "string" } }, { "name": "dataset", "in": "query", "description": "Public dataset name.", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/MutationType" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } } ], "responses": { "200": { "description": "A page. `next_cursor` is always set; keep it even when `data` is empty.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Mutation" } }, "meta": { "type": "object", "required": [ "schema_version", "next_cursor", "has_more", "head_position" ], "properties": { "schema_version": { "const": "mutation.v1" }, "next_cursor": { "type": "string" }, "has_more": { "type": "boolean" }, "head_position": { "type": "integer" } } } } } } } }, "default": { "$ref": "#/components/responses/Error" } } } }, "/mutations/checkpoint": { "get": { "tags": [ "feed" ], "summary": "A cursor at the current head (same filters as /mutations)", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "name": "registration", "in": "query", "schema": { "type": "string" } }, { "name": "dataset", "in": "query", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/MutationType" } } ], "responses": { "200": { "description": "Head.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "position", "cursor" ], "properties": { "position": { "type": "integer" }, "cursor": { "type": "string" } } } } } } } }, "default": { "$ref": "#/components/responses/Error" } } } }, "/mutations/batches": { "get": { "tags": [ "feed" ], "summary": "Imported batches, newest first", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "name": "dataset", "in": "query", "schema": { "type": "string" } }, { "name": "date", "in": "query", "schema": { "type": "string", "format": "date" } }, { "$ref": "#/components/parameters/Limit100" }, { "$ref": "#/components/parameters/PageCursor" } ], "responses": { "200": { "$ref": "#/components/responses/BatchList" }, "default": { "$ref": "#/components/responses/Error" } } } }, "/mutations/batches/{batch}": { "get": { "tags": [ "feed" ], "summary": "One imported batch", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "name": "batch", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Batch.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/FeedBatch" } } } } } }, "default": { "$ref": "#/components/responses/Error" } } } }, "/snapshots": { "get": { "tags": [ "feed" ], "summary": "Completed snapshots, newest first (plan with snapshots)", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "$ref": "#/components/responses/SnapshotList" }, "default": { "$ref": "#/components/responses/Error" } } } }, "/snapshots/{snapshot}": { "get": { "tags": [ "feed" ], "summary": "One completed snapshot", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "$ref": "#/components/parameters/Snapshot" } ], "responses": { "200": { "$ref": "#/components/responses/Snapshot" }, "default": { "$ref": "#/components/responses/Error" } } } }, "/snapshots/{snapshot}/files/{file}/download-url": { "post": { "tags": [ "feed" ], "summary": "A 10-minute signed URL for one snapshot file", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "$ref": "#/components/parameters/Snapshot" }, { "$ref": "#/components/parameters/SnapshotFile" } ], "responses": { "200": { "$ref": "#/components/responses/DownloadUrl" }, "default": { "$ref": "#/components/responses/Error" } } } }, "/mutation-files": { "get": { "tags": [ "feed" ], "summary": "The account's mutation files, newest first (plan with mutation files)", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "$ref": "#/components/parameters/Limit100" }, { "$ref": "#/components/parameters/PageCursor" } ], "responses": { "200": { "$ref": "#/components/responses/MutationFileList" }, "default": { "$ref": "#/components/responses/Error" } } }, "post": { "tags": [ "feed" ], "summary": "Request a mutation file (202), or get the existing one with the same contents (200, not counted)", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "requestBody": { "$ref": "#/components/requestBodies/MutationFileRequest" }, "responses": { "200": { "$ref": "#/components/responses/MutationFile" }, "202": { "$ref": "#/components/responses/MutationFile" }, "default": { "$ref": "#/components/responses/Error" } } } }, "/mutation-files/{mutationFile}": { "get": { "tags": [ "feed" ], "summary": "One mutation file (poll until completed)", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "$ref": "#/components/parameters/MutationFile" } ], "responses": { "200": { "$ref": "#/components/responses/MutationFile" }, "default": { "$ref": "#/components/responses/Error" } } } }, "/mutation-files/{mutationFile}/download-url": { "post": { "tags": [ "feed" ], "summary": "A 10-minute signed URL for a completed mutation file", "security": [ { "apiKey": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "$ref": "#/components/parameters/MutationFile" } ], "responses": { "200": { "$ref": "#/components/responses/DownloadUrl" }, "default": { "$ref": "#/components/responses/Error" } } } } }, "components": { "securitySchemes": { "apiKey": { "type": "http", "scheme": "bearer", "description": "An API key, kf_live_… (kf_test_… outside production)." }, "apiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-Api-Key" } }, "parameters": { "AnalyticsFilter": { "name": "filter", "in": "query", "style": "deepObject", "explode": true, "description": "`filter[make]=TESLA,BMW` (any of the values, any case; booleans take true/false), `filter[first_admission_date][gte]=2020-01-01` (dates as YYYY-MM-DD and metrics take gte, gt, lte, lt). At most 50 values per field.", "schema": { "type": "object", "additionalProperties": true } }, "AnalyticsGroupBy": { "name": "group_by", "in": "query", "description": "Up to 2 comma-separated fields, outer first, e.g. `make,trade_name`. Dates take `:year` or `:month` (month needs a filter on that date spanning at most 120 months).", "schema": { "type": "string" } }, "AnalyticsLimit": { "name": "limit", "in": "query", "description": "Groups per level, largest first.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, "AnalyticsMetrics": { "name": "metrics", "in": "query", "description": "Up to 5 comma-separated `operation:field` (avg, min, max, sum, median), e.g. `avg:catalog_price`.", "schema": { "type": "string" } }, "Limit100": { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, "MutationFile": { "name": "mutationFile", "in": "path", "required": true, "schema": { "type": "string" } }, "PageCursor": { "name": "cursor", "in": "query", "description": "meta.next_cursor of the previous page.", "schema": { "type": "string" } }, "Snapshot": { "name": "snapshot", "in": "path", "required": true, "schema": { "type": "string" } }, "SnapshotFile": { "name": "file", "in": "path", "required": true, "description": "File name, e.g. axles.csv.gz.", "schema": { "type": "string" } } }, "requestBodies": { "MutationFileRequest": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "kind", "format" ], "properties": { "kind": { "type": "string", "enum": [ "daily", "range" ] }, "format": { "type": "string", "enum": [ "jsonl", "csv" ] }, "dataset": { "type": [ "string", "null" ], "description": "Public dataset name." }, "date": { "type": "string", "format": "date", "description": "daily only." }, "after": { "type": "string", "description": "range only; a feed cursor." }, "until": { "type": "string", "description": "range only; a feed cursor." } } } } } } }, "responses": { "Analytics": { "description": "The `analytics.v1` answer.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/AnalyticsLevel" }, { "type": "object", "properties": { "groups": { "oneOf": [ { "type": "null" }, { "type": "array", "items": { "$ref": "#/components/schemas/AnalyticsOuterGroup" } } ] } } } ] }, "meta": { "type": "object", "required": [ "schema_version", "data_version", "datasets", "query" ], "properties": { "schema_version": { "const": "analytics.v1" }, "data_version": { "type": "string" }, "datasets": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Freshness" } }, "query": { "type": "object", "description": "The query in its canonical form (filters by field, values sorted), as answered.", "required": [ "subject", "filter", "group_by", "metrics", "limit" ], "properties": { "subject": { "type": "string", "enum": [ "vehicles", "defects" ] }, "filter": { "type": "object", "description": "Keyed by field: the values, or the range bounds. Empty without filters." }, "group_by": { "type": "array", "items": { "type": "string" } }, "metrics": { "type": "array", "items": { "type": "string" } }, "limit": { "type": "integer" } } } } } } } } } }, "BatchList": { "description": "Batches.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/FeedBatch" } }, "meta": { "$ref": "#/components/schemas/PageMeta" } } } } } }, "DownloadUrl": { "description": "A signed download URL.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "url", "expires_at" ], "properties": { "url": { "type": "string", "format": "uri" }, "expires_at": { "$ref": "#/components/schemas/Timestamp" } } } } } } } }, "Error": { "description": "An error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "MutationFile": { "description": "A mutation file.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/MutationFile" } } } } } }, "MutationFileList": { "description": "Mutation files.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MutationFile" } }, "meta": { "$ref": "#/components/schemas/PageMeta" } } } } } }, "Snapshot": { "description": "A snapshot.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Snapshot" } } } } } }, "SnapshotList": { "description": "Snapshots.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Snapshot" } } } } } } } }, "schemas": { "AnalyticsGroupFields": { "type": "object", "required": [ "key" ], "properties": { "key": { "type": [ "string", "boolean" ], "description": "The value grouped on: a string, true/false for indicators, `2024` or `2024-03` for dates." }, "description": { "type": [ "string", "null" ], "description": "Defect code groups only: from the code's latest catalogue version." }, "article_number": { "type": [ "string", "null" ], "description": "Defect code groups only." } } }, "AnalyticsInnerGroup": { "allOf": [ { "$ref": "#/components/schemas/AnalyticsGroupFields" }, { "$ref": "#/components/schemas/AnalyticsLevel" } ] }, "AnalyticsLevel": { "type": "object", "required": [ "count", "metrics", "groups", "other_count" ], "properties": { "count": { "type": "integer", "description": "Vehicles (subject vehicles) or defect findings (subject defects)." }, "vehicles": { "type": "integer", "description": "Subject defects only: the distinct vehicles the counted defects were found on." }, "metrics": { "type": "object", "additionalProperties": { "type": [ "number", "null" ] }, "description": "Keyed by the requested `operation:field`; null when no vehicle in the group has a value." }, "groups": { "description": "The groups of the next level, largest first (dates oldest first); null without (another) group level. At the innermost level always null." }, "other_count": { "type": [ "integer", "null" ], "description": "Counted items in groups beyond the limit. Null for date groups and for child dataset groups of vehicles (whose leftovers are rows, not vehicles)." } } }, "AnalyticsOuterGroup": { "allOf": [ { "$ref": "#/components/schemas/AnalyticsGroupFields" }, { "$ref": "#/components/schemas/AnalyticsLevel" }, { "type": "object", "properties": { "groups": { "oneOf": [ { "type": "null" }, { "type": "array", "items": { "$ref": "#/components/schemas/AnalyticsInnerGroup" } } ] } } } ] }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id" ], "properties": { "code": { "type": "string", "examples": [ "validation_failed" ] }, "message": { "type": "string" }, "request_id": { "type": "string" }, "details": { "type": "object", "description": "Codes with details: validation_failed (fields), usage_cap_reached, query_cap_reached, mutation_file_limit_reached, cursor_expired, not_entitled, …" } } } } }, "FeedBatch": { "type": "object", "required": [ "id", "dataset", "source_dataset", "source_version", "date", "source_published_at", "observed_at", "imported_at", "counts", "record_count", "first_position", "last_position", "start_cursor", "pruned" ], "properties": { "id": { "type": "string" }, "dataset": { "type": "string" }, "source_dataset": { "type": "string" }, "source_version": { "type": "string" }, "date": { "type": "string", "format": "date" }, "source_published_at": { "$ref": "#/components/schemas/NullableTimestamp" }, "observed_at": { "$ref": "#/components/schemas/Timestamp" }, "imported_at": { "$ref": "#/components/schemas/Timestamp" }, "counts": { "type": "object", "required": [ "appeared", "changed", "disappeared" ], "properties": { "appeared": { "type": "integer" }, "changed": { "type": "integer" }, "disappeared": { "type": "integer" } } }, "record_count": { "type": [ "integer", "null" ] }, "first_position": { "type": [ "integer", "null" ] }, "last_position": { "type": [ "integer", "null" ] }, "start_cursor": { "type": [ "string", "null" ], "description": "Reads the feed from this batch on (no filters); null without records." }, "pruned": { "type": "boolean" } } }, "Freshness": { "type": "object", "required": [ "source_published_at", "last_checked_at", "stale" ], "properties": { "source_published_at": { "$ref": "#/components/schemas/NullableTimestamp" }, "last_checked_at": { "$ref": "#/components/schemas/NullableTimestamp" }, "stale": { "type": "boolean", "description": "Not checked against RDW recently, or its current version not in Elasticsearch yet. Stale data is still served." } } }, "Mutation": { "type": "object", "required": [ "id", "position", "batch_id", "dataset", "registration", "type", "key", "changes", "source_published_at", "observed_at", "effective_at" ], "properties": { "id": { "type": "string", "description": "Deduplicate on this: delivery is at least once." }, "position": { "type": "integer" }, "batch_id": { "type": "string" }, "dataset": { "type": "string" }, "registration": { "type": [ "string", "null" ] }, "type": { "$ref": "#/components/schemas/MutationType" }, "key": { "type": "object", "description": "The record's key fields (dataset key order)." }, "changes": { "type": "array", "items": { "type": "object", "required": [ "field", "source_field", "path", "old", "new" ], "properties": { "field": { "type": "string", "description": "Public field name in the dataset (see GET /datasets)." }, "source_field": { "type": "string", "description": "RDW's column." }, "path": { "type": [ "string", "null" ], "description": "Where the field is in the `vehicle.v1` lookup response (`[]` marks a list), or null for a field the lookup does not carry." }, "old": { "type": [ "string", "number", "boolean", "null" ] }, "new": { "type": [ "string", "number", "boolean", "null" ] } } } }, "source_published_at": { "$ref": "#/components/schemas/NullableTimestamp" }, "observed_at": { "$ref": "#/components/schemas/Timestamp" }, "effective_at": { "type": [ "string", "null" ], "format": "date-time", "description": "Always null: RDW publishes no per-record event time." } } }, "MutationFile": { "type": "object", "required": [ "id", "kind", "format", "dataset", "date", "after_position", "until_position", "status", "schema_version", "file_name", "record_count", "first_position", "last_position", "batch_ids", "bytes", "sha256", "error", "created_at", "completed_at", "expires_at" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "daily", "range" ] }, "format": { "type": "string", "enum": [ "jsonl", "csv" ] }, "dataset": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ], "format": "date" }, "after_position": { "type": [ "integer", "null" ] }, "until_position": { "type": [ "integer", "null" ] }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed", "expired" ] }, "schema_version": { "type": "string" }, "file_name": { "type": "string" }, "record_count": { "type": [ "integer", "null" ] }, "first_position": { "type": [ "integer", "null" ] }, "last_position": { "type": [ "integer", "null" ] }, "batch_ids": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "description": "A day's batches from the request on; a range's once generated." }, "bytes": { "type": [ "integer", "null" ] }, "sha256": { "type": [ "string", "null" ] }, "error": { "type": [ "string", "null" ] }, "created_at": { "$ref": "#/components/schemas/Timestamp" }, "completed_at": { "$ref": "#/components/schemas/NullableTimestamp" }, "expires_at": { "$ref": "#/components/schemas/NullableTimestamp" } } }, "MutationType": { "type": "string", "enum": [ "appeared", "changed", "disappeared" ] }, "NullableTimestamp": { "type": [ "string", "null" ], "format": "date-time" }, "PageMeta": { "type": "object", "required": [ "next_cursor" ], "properties": { "next_cursor": { "type": [ "string", "null" ], "description": "Pass as `cursor` for the next page; null on the last page." } } }, "Snapshot": { "type": "object", "required": [ "id", "schema_version", "aligned_position", "cursor", "started_at", "finished_at", "files" ], "properties": { "id": { "type": "string" }, "schema_version": { "type": "string" }, "aligned_position": { "type": "integer" }, "cursor": { "type": "string", "description": "Read /mutations with after= once the files are loaded." }, "started_at": { "$ref": "#/components/schemas/Timestamp" }, "finished_at": { "$ref": "#/components/schemas/Timestamp" }, "files": { "type": "array", "items": { "type": "object", "required": [ "name", "dataset", "format", "rows", "bytes", "sha256" ], "properties": { "name": { "type": "string", "examples": [ "axles.csv.gz" ] }, "dataset": { "type": "string" }, "format": { "type": "string", "enum": [ "jsonl", "csv" ] }, "rows": { "type": "integer" }, "bytes": { "type": "integer" }, "sha256": { "type": "string" } } } } } }, "Timestamp": { "type": "string", "format": "date-time", "examples": [ "2026-11-03T08:07:10Z" ] }, "Vehicle": { "type": "object", "description": "The `vehicle.v1` record: the register and its child datasets arranged in sections.\nIn the **compact** view (default) a field is either absent or has a value: null fields and empty\ncollections are left out, false and 0 are kept. In the **full** view every field is present (null when\nRDW has no value) and every collection is present (empty when there are no records). `include` limits the\nresponse to the named sections; `registration` and `metadata` are always present. Field names, units and\nnesting are the same in both views. Units are RDW's own (cm, kg, kW, km/h, g/km, l/100 km, Wh/km, km, dB(A),\nrpm, l, EUR) and are named in the field.", "additionalProperties": false, "required": [ "registration", "metadata" ], "properties": { "registration": { "$ref": "#/components/schemas/VehicleRegistration" }, "vehicle": { "$ref": "#/components/schemas/VehicleIdentity" }, "technical": { "$ref": "#/components/schemas/VehicleTechnical" }, "environment": { "$ref": "#/components/schemas/VehicleEnvironment" }, "status": { "$ref": "#/components/schemas/VehicleStatus" }, "inspections": { "$ref": "#/components/schemas/VehicleInspections" }, "history": { "$ref": "#/components/schemas/VehicleHistory" }, "metadata": { "$ref": "#/components/schemas/VehicleMetadata" } } }, "VehicleEnvironment": { "type": "object", "description": "Fuels and energy sources with power, emissions, consumption, range and noise per record. NEDC and WLTP figures are separate fields; weighted figures (plug-in hybrids) are separate from combined ones.", "additionalProperties": false, "properties": { "fuel_efficiency_class": { "type": [ "string", "null" ], "description": "Fuel efficiency label, A to G." }, "gas_installation_type": { "type": [ "string", "null" ], "description": "Type of gas (LPG/CNG) installation." }, "fuels": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sequence": { "type": [ "integer", "null" ], "description": "Order of this fuel for the vehicle." }, "type": { "type": [ "string", "null" ], "description": "Fuel in RDW wording, e.g. \"Benzine\", \"Diesel\" or \"Elektriciteit\"." }, "hybrid_class": { "type": [ "string", "null" ], "description": "Hybrid class: OVC-HEV (externally chargeable), NOVC-HEV, OVC-FCHV or NOVC-FCHV (fuel cell)." }, "declared_max_speed_kmh": { "type": [ "number", "null" ], "description": "Maximum speed declared by the manufacturer (km/h)." }, "power": { "type": "object", "additionalProperties": false, "properties": { "net_max_kw": { "type": [ "number", "null" ], "description": "Net maximum power of the combustion engine (kW)." }, "electric": { "type": "object", "additionalProperties": false, "properties": { "nominal_continuous_max_kw": { "type": [ "number", "null" ], "description": "Nominal continuous maximum power of the electric motor (kW)." }, "max_15_minutes_kw": { "type": [ "number", "null" ], "description": "Maximum electric power over 15 minutes (kW)." }, "net_max_kw": { "type": [ "number", "null" ], "description": "Net maximum electric power (kW)." } } } } }, "emissions": { "type": "object", "additionalProperties": false, "properties": { "euro_class_code": { "type": [ "string", "null" ], "description": "Emission standard (Euro class) code (emissiecode_omschrijving), e.g. \"6\"." }, "exhaust_emission_level": { "type": [ "string", "null" ], "description": "Exhaust emission level (uitlaatemissieniveau), e.g. \"EURO 6 AP\" or \"EURO VI E\"." }, "directive_light": { "type": [ "string", "null" ], "description": "EU emission directive the light vehicle was approved under." }, "directive_heavy": { "type": [ "string", "null" ], "description": "EU emission directive the heavy-duty engine was approved under." }, "co2_class": { "type": [ "string", "null" ], "description": "CO2 emission class (heavy-duty vehicles)." }, "co2": { "type": "object", "additionalProperties": false, "properties": { "combined_g_per_km": { "type": [ "number", "null" ], "description": "Combined CO2 emission (NEDC, g/km)." }, "weighted_g_per_km": { "type": [ "number", "null" ], "description": "Weighted CO2 emission of an externally chargeable hybrid (NEDC, g/km)." }, "combined_wltp_g_per_km": { "type": [ "number", "null" ], "description": "Combined CO2 emission (WLTP, g/km)." }, "weighted_combined_wltp_g_per_km": { "type": [ "number", "null" ], "description": "Weighted combined CO2 emission (WLTP, g/km)." } } }, "particulates": { "type": "object", "additionalProperties": false, "properties": { "light_g_per_km": { "type": [ "number", "null" ], "description": "Particulate emission in g/km (light vehicles) (g/km)." }, "heavy_g_per_kwh": { "type": [ "number", "null" ], "description": "Particulate emission in g/kWh (heavy-duty engines) (g/kWh)." }, "type1_wltp": { "type": [ "number", "null" ], "description": "Particulate mass emission in the WLTP type 1 test (emis_deeltjes_type1_wltp); RDW does not state the unit, so none is named." } } } } }, "consumption": { "type": "object", "additionalProperties": false, "properties": { "fuel": { "type": "object", "additionalProperties": false, "properties": { "combined_l_per_100km": { "type": [ "number", "null" ], "description": "Combined fuel consumption (NEDC, l/100 km)." }, "weighted_combined_l_per_100km": { "type": [ "number", "null" ], "description": "Weighted combined fuel consumption (l/100 km)." }, "combined_wltp_l_per_100km": { "type": [ "number", "null" ], "description": "Combined fuel consumption (WLTP, l/100 km)." }, "weighted_combined_wltp_l_per_100km": { "type": [ "number", "null" ], "description": "Weighted combined fuel consumption (WLTP, l/100 km)." } } }, "electric": { "type": "object", "additionalProperties": false, "properties": { "electric_only_wh_per_km": { "type": [ "number", "null" ], "description": "Electricity consumption when driving fully electric (Wh/km)." }, "weighted_combined_wh_per_km": { "type": [ "number", "null" ], "description": "Weighted combined electricity consumption (Wh/km)." }, "electric_only_wltp_wh_per_km": { "type": [ "number", "null" ], "description": "Electric consumption of a pure electric vehicle (WLTP, Wh/km)." }, "external_charging_wltp_wh_per_km": { "type": [ "number", "null" ], "description": "Electric consumption of an externally chargeable hybrid (WLTP, Wh/km)." } } } } }, "range": { "type": "object", "additionalProperties": false, "properties": { "electric_km": { "type": [ "number", "null" ], "description": "Electric range (km)." }, "external_charging_km": { "type": [ "number", "null" ], "description": "Electric range of an externally chargeable vehicle (km)." }, "electric_only_wltp_km": { "type": [ "number", "null" ], "description": "Range of a pure electric vehicle (WLTP, km)." }, "external_charging_wltp_km": { "type": [ "number", "null" ], "description": "Electric range of an externally chargeable hybrid (WLTP, km)." } } }, "noise": { "type": "object", "additionalProperties": false, "properties": { "driving_db": { "type": [ "number", "null" ], "description": "Noise level while driving (dB(A))." }, "stationary_db": { "type": [ "number", "null" ], "description": "Noise level when stationary with the engine running (dB(A))." }, "measurement_rpm": { "type": [ "number", "null" ], "description": "Engine speed during the stationary noise measurement (rpm)." } } } } } } } }, "VehicleHistory": { "type": "object", "description": "Dated records: objects added to the vehicle and recalls with their status.", "additionalProperties": false, "properties": { "added_objects": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": [ "string", "null" ], "description": "Kind of object, e.g. \"LPG Installatie\" or \"Tachograaf\"." }, "make": { "type": [ "string", "null" ], "description": "Make of the object." }, "make_code": { "type": [ "string", "null" ], "description": "Make code of the object." }, "version_sequence": { "type": [ "integer", "null" ], "description": "Version sequence number of the object." }, "classification": { "type": [ "string", "null" ], "description": "Classification of the object." }, "mounted_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the object was mounted." }, "removed_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the object was removed." }, "gas_tank_capacity_l": { "type": [ "number", "null" ], "description": "Capacity of the gas tank (l)." } } } }, "recalls": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": [ "string", "null" ], "description": "RDW reference code of the recall campaign (referentiecode_rdw)." }, "status": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": [ "string", "null" ], "description": "Status code: O for open, P when the manufacturer reports the vehicle as repaired, or another RDW code." }, "description": { "type": [ "string", "null" ], "description": "Status as reported by the manufacturer, in RDW wording." } } }, "campaign": { "type": [ "object", "null" ], "description": "The recall campaign from the RDW recall register, or null when it is not in the register. Its code is the recall's code.", "additionalProperties": false, "properties": { "published_date": { "type": [ "string", "null" ], "format": "date", "description": "Date RDW published the recall in its register." }, "reporting_party": { "type": [ "string", "null" ], "description": "Manufacturer or distributor that reported the recall." }, "manufacturer_reference": { "type": [ "string", "null" ], "description": "The manufacturer's own code for the recall." }, "defect_description": { "type": [ "string", "null" ], "description": "Description of the defect the recall is for." }, "defect_category": { "type": [ "string", "null" ], "description": "Part of the vehicle the defect concerns." }, "consequences": { "type": [ "string", "null" ], "description": "Consequences of the defect the user may notice." }, "remedy": { "type": [ "string", "null" ], "description": "What is done to repair the defect." }, "risk_assessment": { "type": [ "string", "null" ], "description": "RDW risk assessment of the defect." }, "remarks": { "type": [ "string", "null" ], "description": "Additional remarks from RDW." }, "info_url": { "type": [ "string", "null" ], "description": "Website with more information from the manufacturer or distributor." }, "info_phone": { "type": [ "string", "null" ], "description": "Phone number for more information." }, "announced_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the manufacturer announced the recall." }, "reported_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the recall was reported to RDW." }, "owners_to_be_informed_date": { "type": [ "string", "null" ], "format": "date", "description": "Date by which owners are to be informed." }, "owners_informed_date": { "type": [ "string", "null" ], "format": "date", "description": "Date owners were informed." }, "vehicles_total": { "type": [ "integer", "null" ], "description": "Number of vehicles in the recall worldwide." }, "vehicles_national": { "type": [ "integer", "null" ], "description": "Number of vehicles in the recall in the Netherlands." } } } } } } } }, "VehicleIdentity": { "type": "object", "description": "Identity, classification, appearance, body and type approval.", "additionalProperties": false, "properties": { "type": { "type": [ "string", "null" ], "description": "Kind of vehicle (voertuigsoort) in RDW wording, e.g. \"Personenauto\", \"Bedrijfsauto\", \"Motorfiets\" or \"Aanhangwagen\"." }, "make": { "type": [ "string", "null" ], "description": "Make." }, "model": { "type": [ "string", "null" ], "description": "Trade name (handelsbenaming) as registered by RDW, used as the model name." }, "colors": { "type": "object", "additionalProperties": false, "properties": { "primary": { "type": [ "string", "null" ], "description": "Main colour in RDW wording." }, "secondary": { "type": [ "string", "null" ], "description": "Second colour in RDW wording." } } }, "body": { "type": "object", "additionalProperties": false, "properties": { "style": { "type": [ "string", "null" ], "description": "Body arrangement in RDW wording, e.g. \"hatchback\" or \"stationwagen\"." }, "extended_cab": { "type": [ "boolean", "null" ], "description": "Whether the cab is extended." }, "aerodynamic_devices_code": { "type": [ "string", "null" ], "description": "Code for aerodynamic devices fitted, as recorded by RDW." }, "types": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the body; specifications and classes are those of this body." }, "code": { "type": [ "string", "null" ], "description": "European body type code, e.g. AB." }, "description": { "type": [ "string", "null" ], "description": "European description of the body type." }, "specifications": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the specification." }, "code": { "type": [ "string", "null" ], "description": "European body code of an approved complete or completed vehicle." }, "description": { "type": [ "string", "null" ], "description": "European description of the specification." } } } }, "classes": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the class." }, "code": { "type": [ "string", "null" ], "description": "Vehicle class code set at approval." }, "description": { "type": [ "string", "null" ], "description": "Description of the vehicle class." } } } } } } }, "unmatched_specifications": { "description": "Body specifications whose body_sequence matches no body in types.", "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "body_sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the body this belongs to." }, "sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the specification." }, "code": { "type": [ "string", "null" ], "description": "European body code of an approved complete or completed vehicle." }, "description": { "type": [ "string", "null" ], "description": "European description of the specification." } } } }, "unmatched_classes": { "description": "Vehicle classes whose body_sequence matches no body in types.", "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "body_sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the body this belongs to." }, "sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the class." }, "code": { "type": [ "string", "null" ], "description": "Vehicle class code set at approval." }, "description": { "type": [ "string", "null" ], "description": "Description of the vehicle class." } } } } } }, "seats": { "type": [ "integer", "null" ], "description": "Number of seats, the driver included." }, "passenger_seats_legal": { "type": [ "integer", "null" ], "description": "Legal number of passenger seats." }, "standing_places": { "type": [ "integer", "null" ], "description": "Number of standing places." }, "wheelchair_places": { "type": [ "integer", "null" ], "description": "Number of wheelchair places." }, "doors": { "type": [ "integer", "null" ], "description": "Number of doors." }, "wheels": { "type": [ "integer", "null" ], "description": "Number of wheels." }, "category": { "type": "object", "additionalProperties": false, "properties": { "european": { "type": [ "string", "null" ], "description": "European vehicle category, e.g. M1 or N1." }, "european_addition": { "type": [ "string", "null" ], "description": "Addition to the European vehicle category." }, "european_version_addition": { "type": [ "string", "null" ], "description": "Addition to the European category of the version." }, "national_subcategory": { "type": [ "string", "null" ], "description": "Dutch subcategory of the vehicle." }, "european_subcategories": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the subcategory." }, "code": { "type": [ "string", "null" ], "description": "European code for the special-purpose body type." }, "description": { "type": [ "string", "null" ], "description": "Description of the subcategory." } } } } } }, "type_approval": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": [ "string", "null" ], "description": "Type code from the type approval." }, "variant": { "type": [ "string", "null" ], "description": "Variant code from the type approval." }, "version": { "type": [ "string", "null" ], "description": "Version (uitvoering) code from the type approval." }, "number": { "type": [ "string", "null" ], "description": "EU or national type approval number." }, "amendment_sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the amendment to the EU type approval." }, "designation_number": { "type": [ "string", "null" ], "description": "Designation number (aanwijzingsnummer), where one applies." } } }, "chassis_number_location": { "type": [ "string", "null" ], "description": "Where the chassis number (VIN) is stamped." }, "fiscal": { "type": "object", "additionalProperties": false, "properties": { "catalog_price_eur": { "type": [ "integer", "null" ], "description": "Catalogue price including VAT and BPM (EUR)." }, "gross_bpm_eur": { "type": [ "integer", "null" ], "description": "Gross BPM (registration tax) at first registration (EUR)." } } }, "particulars": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sequence": { "type": [ "integer", "null" ], "description": "Sequence number of the particular." }, "code": { "type": [ "integer", "null" ], "description": "Code of the particular." }, "description": { "type": [ "string", "null" ], "description": "Description of the code, e.g. \"Wielbasis:\"." }, "value": { "type": [ "string", "null" ], "description": "Variable text completing the description, e.g. \"1155-1825\"." }, "unit": { "type": [ "string", "null" ], "description": "Unit of the value, e.g. \"cm\"." } } } } } }, "VehicleInspections": { "type": "object", "description": "Current expiry dates, the odometer judgement and the inspection reports with their defects.", "additionalProperties": false, "properties": { "apk": { "type": "object", "additionalProperties": false, "properties": { "expiry_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the periodic inspection (APK) expires." } } }, "tachograph": { "type": "object", "additionalProperties": false, "properties": { "expiry_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the tachograph inspection expires." } } }, "odometer": { "type": "object", "additionalProperties": false, "properties": { "last_registration_year": { "type": [ "integer", "null" ], "description": "Year the odometer reading was last registered." }, "judgement": { "type": [ "string", "null" ], "description": "RDW judgement of the odometer history in RDW wording, e.g. \"Logisch\" or \"Onlogisch\"." }, "explanation_code": { "type": [ "string", "null" ], "description": "Code explaining the odometer judgement." } } }, "inspection_register": { "description": "Records of RDW's separate inspection register (dataset Keuringen): the current inspection expiry as that register has it, normally one record with the same date as apk.expiry_date.", "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "expiry_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the current inspection expires." } } } }, "reports": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "report_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the inspection station filed the report." }, "report_time": { "type": [ "string", "null" ], "description": "Time the report was filed, as HH:MM. Date, time and approval type code together identify a report." }, "approval_type": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": [ "string", "null" ], "description": "Code of the kind of approval the inspection station holds." }, "description": { "type": [ "string", "null" ], "description": "Kind of approval, e.g. \"APK Lichte voertuigen\" or \"APK Zware voertuigen\"." } } }, "report_type": { "type": [ "string", "null" ], "description": "Kind of report, e.g. a periodic inspection." }, "expiry_date": { "type": [ "string", "null" ], "format": "date", "description": "Inspection expiry date resulting from this report." }, "defects": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": [ "string", "null" ], "description": "Code of the defect in the RDW defect catalogue." }, "count": { "type": [ "integer", "null" ], "description": "How many times the defect was found." }, "description": { "type": [ "string", "null" ], "description": "Description of the defect." }, "article_number": { "type": [ "string", "null" ], "description": "Article number in the inspection rules." } } } } } } }, "unmatched_defects": { "description": "Defects whose report (same date, time and approval type code) is not in the register, kept here with their own report fields instead of being attached to another report.", "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "report_date": { "type": [ "string", "null" ], "format": "date", "description": "Date of the inspection report the defect belongs to." }, "report_time": { "type": [ "string", "null" ], "description": "Time of the inspection report, as HH:MM." }, "approval_type": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": [ "string", "null" ], "description": "Code of the kind of approval the inspection station holds." }, "description": { "type": [ "string", "null" ], "description": "Kind of approval of the inspection station." } } }, "code": { "type": [ "string", "null" ], "description": "Code of the defect in the RDW defect catalogue." }, "count": { "type": [ "integer", "null" ], "description": "How many times the defect was found." }, "description": { "type": [ "string", "null" ], "description": "Description of the defect." }, "article_number": { "type": [ "string", "null" ], "description": "Article number in the inspection rules." } } } } } }, "VehicleMetadata": { "type": "object", "description": "About this response: schema, source, which view and sections, and how fresh the data is.", "additionalProperties": false, "required": [ "schema_version", "source", "view", "sections", "data_version", "stale", "retrieved_at", "datasets" ], "properties": { "schema_version": { "const": "vehicle.v1", "description": "Public schema version of the record. A breaking change gets a new version; additive changes do not." }, "source": { "const": "RDW", "description": "The data source: RDW open data (opendata.rdw.nl). GET /datasets names the datasets." }, "view": { "type": "string", "enum": [ "compact", "full", "raw" ], "description": "The view this response is in." }, "sections": { "description": "Sections in this response, in order (`registration` always); null in the raw view.", "anyOf": [ { "type": "array", "items": { "type": "string", "enum": [ "registration", "vehicle", "technical", "environment", "status", "inspections", "history" ] } }, { "type": "null" } ] }, "data_version": { "type": "string", "description": "Hash of the synced dataset versions the record was built from; changes with every sync." }, "stale": { "type": "boolean", "description": "True when any dataset in `datasets` is stale (see Freshness). Stale data is still served." }, "retrieved_at": { "type": "string", "format": "date-time", "description": "When this response was produced (UTC). Not a data timestamp: see `datasets` for RDW publication (`source_published_at`) and sync (`last_checked_at`) times." }, "datasets": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Freshness" }, "description": "Freshness per dataset (public name): when RDW published the version served, when the sync last checked RDW, and whether it is stale." } } }, "VehicleRaw": { "type": "object", "description": "The **raw** view (`view=raw`): the same typed values under RDW's own dataset and column names, for\ncustomers who know RDW's open data. One key per RDW dataset: the register as an object, each child\ndataset as a list of objects; every mapped column present, null when RDW has no value. Columns the API never\nexposes (RDW API links, columns RDW does not fill) are absent. Enrichments appear under the reference\ndataset's names: `gebrek_omschrijving` and `gebrek_artikel_nummer` in `geconstateerde_gebreken`,\n`terugroep_actie` (object or null) in `terugroepacties`.", "additionalProperties": false, "required": [ "voertuigen", "brandstof", "assen", "carrosserie", "carrosserie_specificatie", "voertuigklasse", "subcategorie", "bijzonderheden", "rupsbanden", "keuringen", "apk_meldingen", "geconstateerde_gebreken", "terugroepacties", "toegevoegde_objecten", "metadata" ], "properties": { "voertuigen": { "type": "object", "required": [ "kenteken" ], "properties": { "kenteken": { "type": "string" } } }, "brandstof": { "type": "array", "items": { "type": "object" } }, "assen": { "type": "array", "items": { "type": "object" } }, "carrosserie": { "type": "array", "items": { "type": "object" } }, "carrosserie_specificatie": { "type": "array", "items": { "type": "object" } }, "voertuigklasse": { "type": "array", "items": { "type": "object" } }, "subcategorie": { "type": "array", "items": { "type": "object" } }, "bijzonderheden": { "type": "array", "items": { "type": "object" } }, "rupsbanden": { "type": "array", "items": { "type": "object" } }, "keuringen": { "type": "array", "items": { "type": "object" } }, "apk_meldingen": { "type": "array", "items": { "type": "object" } }, "geconstateerde_gebreken": { "type": "array", "items": { "type": "object" } }, "terugroepacties": { "type": "array", "items": { "type": "object" } }, "toegevoegde_objecten": { "type": "array", "items": { "type": "object" } }, "metadata": { "$ref": "#/components/schemas/VehicleMetadata" } } }, "VehicleRawResponse": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/VehicleRaw" } } }, "VehicleRegistration": { "type": "object", "description": "Registration identifiers and dates. Always present.", "additionalProperties": false, "required": [ "plate" ], "properties": { "plate": { "type": "string", "description": "Registration (kenteken), uppercase without separators." }, "first_admission_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the vehicle was first admitted to the road, in any country." }, "first_nl_registration_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the vehicle was first registered to an owner in the Netherlands." }, "registration_date": { "type": [ "string", "null" ], "format": "date", "description": "Date of the current registration to an owner (tenaamstelling)." }, "bpm_depreciation_date": { "type": [ "string", "null" ], "format": "date", "description": "Approval date used as the depreciation moment for BPM (registration tax)." } } }, "VehicleResponse": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Vehicle" } } }, "VehicleStatus": { "type": "object", "description": "Indicators. true/false are RDW's answer; null (absent in the compact view) means RDW gives none.", "additionalProperties": false, "properties": { "insured": { "type": [ "boolean", "null" ], "description": "Whether third-party liability (WAM) insurance is registered; null (absent in the compact view) when RDW gives no answer, e.g. not applicable." }, "exported": { "type": [ "boolean", "null" ], "description": "Whether the vehicle has been exported." }, "taxi": { "type": [ "boolean", "null" ], "description": "Whether the vehicle is registered as a taxi." }, "open_recall": { "type": [ "boolean", "null" ], "description": "Whether a recall is open for the vehicle." }, "registration_allowed": { "type": [ "boolean", "null" ], "description": "Whether the vehicle can currently be registered to an owner." } } }, "VehicleTechnical": { "type": "object", "description": "Technical specifications. Lengths in cm, masses in kg, as RDW publishes them.", "additionalProperties": false, "properties": { "engine": { "type": "object", "additionalProperties": false, "properties": { "cylinders": { "type": [ "integer", "null" ], "description": "Number of cylinders." }, "displacement_cc": { "type": [ "integer", "null" ], "description": "Engine displacement (cc)." }, "power_to_mass_ratio_kw_per_kg": { "type": [ "number", "null" ], "description": "Power per ready-to-drive mass (kW/kg)." } } }, "dimensions": { "type": "object", "additionalProperties": false, "properties": { "length_cm": { "type": [ "integer", "null" ], "description": "Length (cm)." }, "length_min_cm": { "type": [ "integer", "null" ], "description": "Minimum length, for vehicles with a variable length (cm)." }, "length_max_cm": { "type": [ "integer", "null" ], "description": "Maximum length, for vehicles with a variable length (cm)." }, "width_cm": { "type": [ "integer", "null" ], "description": "Width (cm)." }, "width_min_cm": { "type": [ "integer", "null" ], "description": "Minimum width (cm)." }, "width_max_cm": { "type": [ "integer", "null" ], "description": "Maximum width (cm)." }, "height_cm": { "type": [ "integer", "null" ], "description": "Height (cm)." }, "height_min_cm": { "type": [ "integer", "null" ], "description": "Minimum height (cm)." }, "height_max_cm": { "type": [ "integer", "null" ], "description": "Maximum height (cm)." }, "wheelbase_cm": { "type": [ "integer", "null" ], "description": "Wheelbase (cm)." }, "wheelbase_min_cm": { "type": [ "integer", "null" ], "description": "Minimum wheelbase (cm)." }, "wheelbase_max_cm": { "type": [ "integer", "null" ], "description": "Maximum wheelbase (cm)." }, "front_to_coupling_cm": { "type": [ "integer", "null" ], "description": "Distance from the front of the vehicle to the centre of the coupling (cm)." }, "coupling_to_rear_cm": { "type": [ "integer", "null" ], "description": "Distance from the centre of the coupling to the rear of the vehicle (cm)." } } }, "weights": { "type": "object", "additionalProperties": false, "properties": { "empty_kg": { "type": [ "integer", "null" ], "description": "Mass of the empty vehicle (kg)." }, "curb_kg": { "type": [ "integer", "null" ], "description": "Ready-to-drive mass (massa rijklaar) (kg)." }, "payload_kg": { "type": [ "integer", "null" ], "description": "Payload (kg)." }, "maximum_kg": { "type": [ "integer", "null" ], "description": "Permitted maximum mass (kg)." }, "technical_maximum_kg": { "type": [ "integer", "null" ], "description": "Technically permitted maximum mass (kg)." }, "technical_maximum_min_kg": { "type": [ "integer", "null" ], "description": "Lower bound of the technically permitted maximum mass (kg)." }, "technical_maximum_max_kg": { "type": [ "integer", "null" ], "description": "Upper bound of the technically permitted maximum mass (kg)." }, "operating_min_kg": { "type": [ "integer", "null" ], "description": "Minimum mass in running order (kg)." }, "operating_max_kg": { "type": [ "integer", "null" ], "description": "Maximum mass in running order (kg)." }, "combination_maximum_kg": { "type": [ "integer", "null" ], "description": "Maximum mass of the vehicle combination (kg)." }, "alternative_drive_kg": { "type": [ "integer", "null" ], "description": "Additional mass of an alternative drivetrain (kg)." }, "average_load_value": { "type": [ "number", "null" ], "description": "Average payload value used for heavy-duty CO2 classification (gem_lading_wrde); RDW does not state the unit, so none is named." }, "towing": { "type": "object", "additionalProperties": false, "properties": { "unbraked_kg": { "type": [ "integer", "null" ], "description": "Maximum mass of an unbraked trailer (kg)." }, "braked_kg": { "type": [ "integer", "null" ], "description": "Maximum mass of a braked trailer (kg)." }, "semi_trailer_braked_kg": { "type": [ "integer", "null" ], "description": "Maximum mass of a braked semi-trailer (kg)." }, "trailer_autonomous_braked_kg": { "type": [ "integer", "null" ], "description": "Maximum mass of an autonomously braked trailer (kg)." }, "center_axle_trailer_braked_kg": { "type": [ "integer", "null" ], "description": "Maximum mass of a braked centre-axle trailer (kg)." } } }, "coupling": { "type": "object", "additionalProperties": false, "properties": { "point_technical_maximum_kg": { "type": [ "integer", "null" ], "description": "Technically permitted mass on the coupling point (kg)." }, "front_axles_load_coupled_kg": { "type": [ "integer", "null" ], "description": "Maximum load under the front axle(s) together with the coupling (kg)." }, "vertical_load_towed_kg": { "type": [ "integer", "null" ], "description": "Vertical load on the coupling point of a towed vehicle (kg)." } } } } }, "speed": { "type": "object", "additionalProperties": false, "properties": { "max_design_kmh": { "type": [ "integer", "null" ], "description": "Maximum design speed (km/h)." }, "deviating_max_kmh": { "type": [ "integer", "null" ], "description": "Deviating maximum speed, where one applies (km/h)." }, "max_assisted_kmh": { "type": [ "integer", "null" ], "description": "Maximum speed up to which the motor assists (e.g. speed pedelecs) (km/h)." } } }, "brake_system_type_code": { "type": [ "string", "null" ], "description": "Code of the vehicle's brake system type." }, "tracks": { "type": "object", "additionalProperties": false, "properties": { "configuration_code": { "type": [ "string", "null" ], "description": "Code of the track (caterpillar) undercarriage configuration." }, "sets": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "set_number": { "type": [ "integer", "null" ], "description": "Sequence number of the track set." }, "driven": { "type": [ "boolean", "null" ], "description": "Whether the track set is driven." }, "braked": { "type": [ "boolean", "null" ], "description": "Whether the track set is braked." }, "technical_max_kg": { "type": [ "integer", "null" ], "description": "Technically permitted maximum mass on the track set (kg)." }, "technical_max_min_kg": { "type": [ "integer", "null" ], "description": "Lower bound of the technically permitted maximum mass (kg)." }, "technical_max_max_kg": { "type": [ "integer", "null" ], "description": "Upper bound of the technically permitted maximum mass (kg)." } } } } } }, "axles": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "number": { "type": [ "integer", "null" ], "description": "Number of the physical axle, counted from the front." }, "axle_count": { "type": [ "integer", "null" ], "description": "Total number of axles of the vehicle as RDW records it on this axle (aantal_assen); not the number of axle records." }, "position_code": { "type": [ "string", "null" ], "description": "V for a front axle, A for a rear axle." }, "driven": { "type": [ "boolean", "null" ], "description": "Whether the axle is driven." }, "liftable_code": { "type": [ "string", "null" ], "description": "Whether the axle can be lifted (hefas): J or N per RDW, other codes occur in the data." }, "braked": { "type": [ "boolean", "null" ], "description": "Whether the axle is braked." }, "track_width_cm": { "type": [ "integer", "null" ], "description": "Track width of the axle (cm)." }, "road_behaviour_code": { "type": [ "string", "null" ], "description": "Suspension of a driven axle: L air suspension, G equivalent to air suspension, A other." }, "loads": { "type": "object", "additionalProperties": false, "properties": { "legal_max_kg": { "type": [ "integer", "null" ], "description": "Legally permitted maximum axle load (kg)." }, "technical_max_kg": { "type": [ "integer", "null" ], "description": "Technically permitted maximum axle load given by the manufacturer (kg)." }, "technical_max_min_kg": { "type": [ "integer", "null" ], "description": "Lower bound of the technically permitted axle load (kg)." }, "technical_max_max_kg": { "type": [ "integer", "null" ], "description": "Upper bound of the technically permitted axle load (kg)." } } }, "distance_to_next_axle_cm": { "type": [ "integer", "null" ], "description": "Distance to the next axle (cm)." }, "distance_to_next_axle_min_cm": { "type": [ "integer", "null" ], "description": "Minimum distance to the next axle (cm)." }, "distance_to_next_axle_max_cm": { "type": [ "integer", "null" ], "description": "Maximum distance to the next axle (cm)." } } } } } } } } }