UK registrations only. The uk path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup.
Requires a valid API key with vdb_read. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as Authorization: Bearer <API_KEY>.
Successful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts.
Every retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return 503 test_registration_unavailable; they never trigger a provider call. An Idempotency-Key is scoped to the account and normalized plate; reusing it for a different plate returns 409. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key.
The engine object follows the engine-details layout: use engine.performance for OEM data and engine.tuning.stages for tuned data. A matched engine includes the full account-visible catalog details and customisations.
Without a reliable match, known registration specifications fill the same fields, engine.id is null, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog.
Broad registration attributes remain under vehicle.details. Power is metric horsepower (PS), torque is Nm.
Unique key shared by retries of this lookup, such as a UUID.
Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$
Body
application/json
vrm
string
required
Required string length: 2 - 32
Example:
"SA22NNB"
Response
Matched, estimated, unavailable or vehicle_not_found result. A successful vehicle observation is billable even when matching or estimates are unavailable.
lookup_id
integer<int64>
required
Required range: 0 <= x <= 9007199254740991
status
enum<string>
required
Available options:
matched,
estimated,
unavailable,
vehicle_not_found
vehicle
object | null
required
Normalized vehicle observation and comprehensive registration-specific details. Power is converted with distinct PS and BHP factors; reported_power preserves received values. Full VINs remain internal. Null means evidence is missing. Service identity, credentials, billing and request metadata are never returned. Hybrid top-level power and torque are null; use performance_components with its explicit attribution. Original generic values remain in reported_power and details and must not be treated as combustion specifications.
Show child attributes
engine
object | null
required
Engine-details layout, matching GET /engines/{engine_id}, plus lookup provenance. Matched engines include the visible catalog details and account customisations. Unmatched vehicles include known registration specifications and available estimated stages; catalog IDs and unknown facts are null, unsupported equipment is empty; illustrative combustion curves are generated only with reliable component power/torque, known fuel/aspiration and a valid unique template. The whole object is null for a missing vehicle or a catalog visibility restriction. An unavailable estimate may still return known engine details.
Show child attributes
match
object | null
required
Show child attributes
provisional_id
integer<int64> | null
required
A separate staging reference, never a catalog engine ID.
Required range: 0 <= x <= 9007199254740991
stages
object[]
required
Compact stages retained for compatibility. New engine-style widgets can use engine.performance and engine.tuning.stages; both stage representations describe the same result.
Show child attributes
cache
object | null
required
Show child attributes
consumption
enum<string>
required
Consumption by this request execution. Cached and idempotent replays consume none.
Available options:
none,
included,
credits
usage
object
required
Current usage when normal VRM access is authorized; null for test-only access. Test-only access does not create an allowance period.
True for a staff-designated saved test registration. These lookups never consume included or purchased credits.
reason
string | null
Resolution or estimation reason. combustion_performance_unattributed means hybrid combustion power/torque are not separately identified; combustion_data_conflicting means component measurements or fuel disagree. Such results withhold tuning stages and curves.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Remapdb Docs","colors":{"primary":"#31374A","light":"#ffffff","dark":"#ffffff"},"logo":{"light":"https://mintcdn.com/remapdb/kv3qo15nTX1Sjbyu/assets/branding/remapdb-logo-small-full-light.svg?fit=max\u0026auto=format\u0026n=kv3qo15nTX1Sjbyu\u0026q=85\u0026s=43a8b24bbe8a0dbd37bf83eb53389324","dark":"https://mintcdn.com/remapdb/kv3qo15nTX1Sjbyu/assets/branding/remapdb-logo-small-full-dark.svg?fit=max\u0026auto=format\u0026n=kv3qo15nTX1Sjbyu\u0026q=85\u0026s=f46eb40e1d7f5b94d72d19d2d42a13ef","href":"/"},"favicon":"https://mintcdn.com/remapdb/kv3qo15nTX1Sjbyu/assets/branding/remapdb-favicon.svg?fit=max\u0026auto=format\u0026n=kv3qo15nTX1Sjbyu\u0026q=85\u0026s=0fcc7a0b57d48d4b33a6d3991596ef33","background":{"color":{"light":"#ffffff","dark":"#0F111A"}},"navbar":{"links":[{"href":"https://app.remapdb.com/support","label":"Get support"}],"primary":{"type":"button","label":"Get started","href":"https://app.remapdb.com/signup"}},"fonts":{"family":"Nunito Sans"},"icons":{"library":"lucide"},"contextual":{"options":["copy","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"light","background":"https://mintlify.s3.us-west-1.amazonaws.com/remapdb/%23F5F7FB"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"remapdb","hasAudioNarration":false,"actualSubdomain":"remapdb","customDomains":["docs.remapdb.com"],"gitSource":{"type":"github","owner":"bitmeshltd","repo":"remapdb-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb1892eb13d58ceec02d70","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"Documentation","count":59},{"language":"default","tag":"API reference","count":42},{"language":"default","tag":"API v2","count":29},{"language":"default","tag":"Widget","count":25},{"language":"default","tag":"ECU observation","count":12},{"language":"default","tag":"API","count":11},{"language":"default","tag":"Settings","count":11},{"language":"default","tag":"API v1 (deprecated)","count":11},{"language":"default","tag":"Quoting","count":8},{"language":"default","tag":"Branding","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"help/style.css","content":":root{--rdb-radius: .125rem;--rdb-nav-active-bg: #d2d7e1;--rdb-nav-active-fg: #2f3850;--rdb-nav-active-bg-dark: #343c53;--rdb-nav-active-fg-dark: #f3f6ff;--rdb-gray-900: #31374A;--rdb-gray-200: #E3E6ED;--rdb-gray-300: #CBD0DD;--rdb-gray-500: #8A94AD}.rounded-sm,.callout{border-radius:var(--rdb-radius)!important}#navbar nav ul li>a,#navbar nav ul li>button,#navbar .navbar-link>a,#sidebar-content a,#sidebar-content button,#navigation-items a,#navigation-items button,#search-bar-entry,#assistant-entry,#search-bar-entry-mobile,#assistant-entry-mobile,#topbar-cta-button>a,#topbar-cta-button>a>span,#page-context-menu,#page-context-menu>button,#page-context-menu>div,#page-context-menu>div>button,#pagination>a{border-radius:var(--rdb-radius)!important}[data-component-name=\"theme-toggle\"],[data-component-name=\"theme-toggle\"]:hover{border-radius:var(--rdb-radius)!important}#sidebar-content .sidebar-group-header,#sidebar-content .sidebar-group-header h5{font-size:14px!important;font-weight:400!important}.dark #sidebar-content .sidebar-group-header,.dark #sidebar-content .sidebar-group-header h5{color:var(--rdb-gray-500)!important}#navigation-items li[data-active=\"true\"]>a,#sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg)!important;color:var(--rdb-nav-active-fg)!important;font-weight:700!important;border-radius:var(--rdb-radius)!important}#navigation-items li[data-active=\"true\"]>a :is(span,svg),#sidebar-content li[data-active=\"true\"]>a :is(span,svg){color:var(--rdb-nav-active-fg)!important}.dark #content-area{color:var(--rdb-gray-300)!important}.dark #navigation-items li[data-active=\"true\"]>a,.dark #sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg-dark)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-active=\"true\"]>a :is(span,svg),.dark #sidebar-content li[data-active=\"true\"]>a :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li:not([data-active=\"true\"])>a,.dark #navigation-items li:not([data-active=\"true\"])>button,.dark #sidebar-content li:not([data-active=\"true\"])>a,.dark #sidebar-content li:not([data-active=\"true\"])>button{color:var(--rdb-gray-500)!important}.dark #navigation-items li:not([data-active=\"true\"])>a :is(span,svg),.dark #navigation-items li:not([data-active=\"true\"])>button :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>a :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>button :is(span,svg){color:var(--rdb-gray-500)!important}.dark #navigation-items li[data-group-tag]>button:hover,.dark #sidebar-content li[data-group-tag]>button:hover{background:color-mix(in srgb, var(--rdb-nav-active-bg-dark) 40%, transparent)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag]>button:hover :is(div,svg),.dark #sidebar-content li[data-group-tag]>button:hover :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button,.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button{background:transparent!important;color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button :is(div,svg),.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover,.dark #navigation-items button:hover,.dark #sidebar-content a:hover,.dark #sidebar-content button:hover{color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover :is(span,svg),.dark #navigation-items button:hover :is(span,svg),.dark #sidebar-content a:hover :is(span,svg),.dark #sidebar-content button:hover :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents-content a{color:var(--rdb-gray-500)!important}#table-of-contents-content li.active>a,#table-of-contents-content li[data-active=\"true\"]>a,#table-of-contents-content a[aria-current=\"true\"],#table-of-contents-content a[aria-current=\"location\"],#table-of-contents-content a[aria-current=\"page\"]{font-weight:600!important}.dark #table-of-contents-content li.active>a,.dark #table-of-contents-content li[data-active=\"true\"]>a,.dark #table-of-contents-content a[aria-current=\"true\"],.dark #table-of-contents-content a[aria-current=\"location\"],.dark #table-of-contents-content a[aria-current=\"page\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #table-of-contents-content li.active::before,.dark #table-of-contents-content li[data-active=\"true\"]::before{background-color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents a[class*=\"text-primary\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important}.dark #content-area .eyebrow{color:var(--rdb-nav-active-fg-dark)!important}.dark [data-component-part=\"card-title\"],.dark [data-component-part=\"card-content\"]{color:var(--rdb-gray-300)!important}.dark [data-component-part=\"card-icon\"]>svg,.dark #card-link-arrow-icon{color:var(--rdb-gray-300)!important;background-color:var(--rdb-gray-300)!important}#navbar nav ul li>a.link{font-weight:700!important}#topbar-cta-button>a{font-weight:700!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{border-radius:var(--rdb-radius)!important;border:2px solid var(--rdb-gray-900)!important;font-weight:700!important;text-decoration:none!important;background:transparent!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important;background:color-mix(in srgb, var(--rdb-gray-900) 15%, transparent)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{color:var(--rdb-gray-300)!important;border-color:var(--rdb-gray-300)!important}.dark #topbar-cta-button>a{background:var(--rdb-nav-active-bg-dark)!important}.dark #topbar-cta-button>a span{color:var(--rdb-nav-active-fg-dark)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,.dark #navbar nav a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-200)!important;color:var(--rdb-gray-200)!important;background:color-mix(in srgb, var(--rdb-gray-300) 25%, transparent)!important}"},{"filePath":"style.css","content":":root{--rdb-radius: .125rem;--rdb-nav-active-bg: #d2d7e1;--rdb-nav-active-fg: #2f3850;--rdb-nav-active-bg-dark: #343c53;--rdb-nav-active-fg-dark: #f3f6ff;--rdb-gray-900: #31374A;--rdb-gray-200: #E3E6ED;--rdb-gray-300: #CBD0DD;--rdb-gray-500: #8A94AD;--rdb-gray-900: #31374a;--rdb-cyan-50: #f0faff;--rdb-cyan-500: #0097eb;--rdb-cyan-1000: #072b3a}.rounded-sm,.callout{border-radius:var(--rdb-radius)!important}.callout[data-callout-type=\"info\"]{border:1px solid var(--rdb-cyan-500)!important;background:var(--rdb-cyan-50)!important;color:var(--rdb-gray-900)!important}.callout[data-callout-type=\"info\"] :is(p,span,strong,em,li,code){color:inherit!important}.callout[data-callout-type=\"info\"] a{color:var(--rdb-gray-900)!important}.callout[data-callout-type=\"info\"] :is(svg,.material-symbols-outlined,[data-icon]){color:var(--rdb-cyan-500)!important}.dark .callout[data-callout-type=\"info\"]{border-color:var(--rdb-cyan-500)!important;background:var(--rdb-cyan-1000)!important;color:var(--rdb-gray-300)!important}.dark .callout[data-callout-type=\"info\"] a{color:var(--rdb-gray-300)!important}.dark .callout[data-callout-type=\"info\"] :is(svg,.material-symbols-outlined,[data-icon]){color:var(--rdb-cyan-500)!important}.code-block,[data-component-part=\"code-block-root\"]{border-radius:var(--rdb-radius)!important}#navbar nav ul li>a,#navbar nav ul li>button,#navbar .navbar-link>a,#sidebar-content a,#sidebar-content button,#navigation-items a,#navigation-items button,#search-bar-entry,#assistant-entry,#search-bar-entry-mobile,#assistant-entry-mobile,#topbar-cta-button>a,#topbar-cta-button>a>span,#page-context-menu,#page-context-menu>button,#page-context-menu>div,#page-context-menu>div>button,#pagination>a{border-radius:var(--rdb-radius)!important}[data-component-name=\"theme-toggle\"],[data-component-name=\"theme-toggle\"]:hover{border-radius:var(--rdb-radius)!important}#sidebar-content .sidebar-group-header,#sidebar-content .sidebar-group-header h5{font-size:14px!important;font-weight:400!important}.dark #sidebar-content .sidebar-group-header,.dark #sidebar-content .sidebar-group-header h5{color:var(--rdb-gray-500)!important}#navigation-items li[data-active=\"true\"]>a,#sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg)!important;color:var(--rdb-nav-active-fg)!important;font-weight:700!important;border-radius:var(--rdb-radius)!important}#navigation-items li[data-active=\"true\"]>a>div:last-child,#navigation-items li[data-active=\"true\"]>a>div:last-child :is(span,svg),#sidebar-content li[data-active=\"true\"]>a>div:last-child,#sidebar-content li[data-active=\"true\"]>a>div:last-child :is(span,svg){color:var(--rdb-nav-active-fg)!important}#navigation-items li[data-active=\"true\"]>a>div:first-child:not(:last-child),#navigation-items li[data-active=\"true\"]>a>div:first-child:not(:last-child) :is(span,div),#sidebar-content li[data-active=\"true\"]>a>div:first-child:not(:last-child),#sidebar-content li[data-active=\"true\"]>a>div:first-child:not(:last-child) :is(span,div){color:#fff!important}.dark #content-area{color:var(--rdb-gray-300)!important}.dark #navigation-items li[data-active=\"true\"]>a,.dark #sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg-dark)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-active=\"true\"]>a>div:last-child,.dark #navigation-items li[data-active=\"true\"]>a>div:last-child :is(span,svg),.dark #sidebar-content li[data-active=\"true\"]>a>div:last-child,.dark #sidebar-content li[data-active=\"true\"]>a>div:last-child :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li:not([data-active=\"true\"])>a,.dark #navigation-items li:not([data-active=\"true\"])>button,.dark #sidebar-content li:not([data-active=\"true\"])>a,.dark #sidebar-content li:not([data-active=\"true\"])>button{color:var(--rdb-gray-500)!important}.dark #navigation-items li:not([data-active=\"true\"])>a :is(span,svg),.dark #navigation-items li:not([data-active=\"true\"])>button :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>a :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>button :is(span,svg){color:var(--rdb-gray-500)!important}.dark #navigation-items li[data-group-tag]>button:hover,.dark #sidebar-content li[data-group-tag]>button:hover{background:color-mix(in srgb, var(--rdb-nav-active-bg-dark) 40%, transparent)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag]>button:hover :is(div,svg),.dark #sidebar-content li[data-group-tag]>button:hover :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button,.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button{background:transparent!important;color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button :is(div,svg),.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover,.dark #navigation-items button:hover,.dark #sidebar-content a:hover,.dark #sidebar-content button:hover{color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover :is(span,svg),.dark #navigation-items button:hover :is(span,svg),.dark #sidebar-content a:hover :is(span,svg),.dark #sidebar-content button:hover :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents-content a{color:var(--rdb-gray-500)!important}#table-of-contents-content li.active>a,#table-of-contents-content li[data-active=\"true\"]>a,#table-of-contents-content a[aria-current=\"true\"],#table-of-contents-content a[aria-current=\"location\"],#table-of-contents-content a[aria-current=\"page\"]{font-weight:600!important}.dark #table-of-contents-content li.active>a,.dark #table-of-contents-content li[data-active=\"true\"]>a,.dark #table-of-contents-content a[aria-current=\"true\"],.dark #table-of-contents-content a[aria-current=\"location\"],.dark #table-of-contents-content a[aria-current=\"page\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #table-of-contents-content li.active::before,.dark #table-of-contents-content li[data-active=\"true\"]::before{background-color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents a[class*=\"text-primary\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important}.dark #content-area .eyebrow{color:var(--rdb-nav-active-fg-dark)!important}.dark [data-component-part=\"card-title\"],.dark [data-component-part=\"card-content\"]{color:var(--rdb-gray-300)!important}.dark [data-component-part=\"card-icon\"]>svg,.dark #card-link-arrow-icon{color:var(--rdb-gray-300)!important;background-color:var(--rdb-gray-300)!important}#navbar nav ul li>a.link{font-weight:700!important}#topbar-cta-button>a{font-weight:700!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{border-radius:var(--rdb-radius)!important;border:2px solid var(--rdb-gray-900)!important;font-weight:700!important;text-decoration:none!important;background:transparent!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important;background:color-mix(in srgb, var(--rdb-gray-900) 15%, transparent)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{color:var(--rdb-gray-300)!important;border-color:var(--rdb-gray-300)!important}.dark #topbar-cta-button>a{background:var(--rdb-nav-active-bg-dark)!important}.dark #topbar-cta-button>a span{color:var(--rdb-nav-active-fg-dark)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,.dark #navbar nav a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-200)!important;color:var(--rdb-gray-200)!important;background:color-mix(in srgb, var(--rdb-gray-300) 25%, transparent)!important}.dark [data-testid=\"api-playground-modal\"] .text-playground-input,.dark #content-area [id^=\"api-playground-\"] .text-playground-input{color:var(--rdb-gray-300)!important}.dark [data-testid=\"api-playground-modal\"] .text-playground-input::placeholder,.dark [data-testid=\"api-playground-modal\"] input.text-playground-input::-webkit-input-placeholder,.dark [data-testid=\"api-playground-modal\"] textarea.text-playground-input::-webkit-input-placeholder,.dark #content-area [id^=\"api-playground-\"] .text-playground-input::placeholder,.dark #content-area [id^=\"api-playground-\"] input.text-playground-input::placeholder,.dark #content-area [id^=\"api-playground-\"] textarea.text-playground-input::placeholder{color:var(--rdb-gray-300)!important;opacity:1!important}.dark [data-testid=\"api-playground-modal\"] select.text-playground-input,.dark #content-area [id^=\"api-playground-\"] select.text-playground-input{color:var(--rdb-gray-300)!important}.dark #content-area [id^=\"api-playground-\"] .text-primary,.dark #content-area [id^=\"api-playground-\"] .dark\\\\:text-primary-light,.dark #content-area [id^=\"response-\"] .text-primary,.dark #content-area [id^=\"response-\"] .dark\\\\:text-primary-light,.dark #content-area .param-head .text-primary,.dark #content-area .param-head .dark\\\\:text-primary-light{color:var(--rdb-nav-active-fg-dark)!important}.plan-comparison-tables table{table-layout:fixed}.plan-comparison-tables table :is(th,td){min-width:0;overflow-wrap:anywhere}.plan-comparison-tables table th:first-child{width:34%}"},{"filePath":"docs/style.css","content":":root{--rdb-radius: .125rem;--rdb-nav-active-bg: #d2d7e1;--rdb-nav-active-fg: #2f3850;--rdb-nav-active-bg-dark: #343c53;--rdb-nav-active-fg-dark: #f3f6ff;--rdb-gray-900: #31374A;--rdb-gray-200: #E3E6ED;--rdb-gray-300: #CBD0DD;--rdb-gray-500: #8A94AD;--rdb-gray-900: #31374a;--rdb-cyan-50: #f0faff;--rdb-cyan-500: #0097eb;--rdb-cyan-1000: #072b3a}.rounded-sm,.callout{border-radius:var(--rdb-radius)!important}.callout[data-callout-type=\"info\"]{border:1px solid var(--rdb-cyan-500)!important;background:var(--rdb-cyan-50)!important;color:var(--rdb-gray-900)!important}.callout[data-callout-type=\"info\"] :is(p,span,strong,em,li,code){color:inherit!important}.callout[data-callout-type=\"info\"] a{color:var(--rdb-gray-900)!important}.callout[data-callout-type=\"info\"] :is(svg,.material-symbols-outlined,[data-icon]){color:var(--rdb-cyan-500)!important}.dark .callout[data-callout-type=\"info\"]{border-color:var(--rdb-cyan-500)!important;background:var(--rdb-cyan-1000)!important;color:var(--rdb-gray-300)!important}.dark .callout[data-callout-type=\"info\"] a{color:var(--rdb-gray-300)!important}.dark .callout[data-callout-type=\"info\"] :is(svg,.material-symbols-outlined,[data-icon]){color:var(--rdb-cyan-500)!important}.code-block,[data-component-part=\"code-block-root\"]{border-radius:var(--rdb-radius)!important}#navbar nav ul li>a,#navbar nav ul li>button,#navbar .navbar-link>a,#sidebar-content a,#sidebar-content button,#navigation-items a,#navigation-items button,#search-bar-entry,#assistant-entry,#search-bar-entry-mobile,#assistant-entry-mobile,#topbar-cta-button>a,#topbar-cta-button>a>span,#page-context-menu,#page-context-menu>button,#page-context-menu>div,#page-context-menu>div>button,#pagination>a{border-radius:var(--rdb-radius)!important}[data-component-name=\"theme-toggle\"],[data-component-name=\"theme-toggle\"]:hover{border-radius:var(--rdb-radius)!important}#sidebar-content .sidebar-group-header,#sidebar-content .sidebar-group-header h5{font-size:14px!important;font-weight:400!important}.dark #sidebar-content .sidebar-group-header,.dark #sidebar-content .sidebar-group-header h5{color:var(--rdb-gray-500)!important}#navigation-items li[data-active=\"true\"]>a,#sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg)!important;color:var(--rdb-nav-active-fg)!important;font-weight:700!important;border-radius:var(--rdb-radius)!important}#navigation-items li[data-active=\"true\"]>a>div:last-child,#navigation-items li[data-active=\"true\"]>a>div:last-child :is(span,svg),#sidebar-content li[data-active=\"true\"]>a>div:last-child,#sidebar-content li[data-active=\"true\"]>a>div:last-child :is(span,svg){color:var(--rdb-nav-active-fg)!important}#navigation-items li[data-active=\"true\"]>a>div:first-child:not(:last-child),#navigation-items li[data-active=\"true\"]>a>div:first-child:not(:last-child) :is(span,div),#sidebar-content li[data-active=\"true\"]>a>div:first-child:not(:last-child),#sidebar-content li[data-active=\"true\"]>a>div:first-child:not(:last-child) :is(span,div){color:#fff!important}.dark #content-area{color:var(--rdb-gray-300)!important}.dark #navigation-items li[data-active=\"true\"]>a,.dark #sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg-dark)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-active=\"true\"]>a>div:last-child,.dark #navigation-items li[data-active=\"true\"]>a>div:last-child :is(span,svg),.dark #sidebar-content li[data-active=\"true\"]>a>div:last-child,.dark #sidebar-content li[data-active=\"true\"]>a>div:last-child :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li:not([data-active=\"true\"])>a,.dark #navigation-items li:not([data-active=\"true\"])>button,.dark #sidebar-content li:not([data-active=\"true\"])>a,.dark #sidebar-content li:not([data-active=\"true\"])>button{color:var(--rdb-gray-500)!important}.dark #navigation-items li:not([data-active=\"true\"])>a :is(span,svg),.dark #navigation-items li:not([data-active=\"true\"])>button :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>a :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>button :is(span,svg){color:var(--rdb-gray-500)!important}.dark #navigation-items li[data-group-tag]>button:hover,.dark #sidebar-content li[data-group-tag]>button:hover{background:color-mix(in srgb, var(--rdb-nav-active-bg-dark) 40%, transparent)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag]>button:hover :is(div,svg),.dark #sidebar-content li[data-group-tag]>button:hover :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button,.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button{background:transparent!important;color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button :is(div,svg),.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover,.dark #navigation-items button:hover,.dark #sidebar-content a:hover,.dark #sidebar-content button:hover{color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover :is(span,svg),.dark #navigation-items button:hover :is(span,svg),.dark #sidebar-content a:hover :is(span,svg),.dark #sidebar-content button:hover :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents-content a{color:var(--rdb-gray-500)!important}#table-of-contents-content li.active>a,#table-of-contents-content li[data-active=\"true\"]>a,#table-of-contents-content a[aria-current=\"true\"],#table-of-contents-content a[aria-current=\"location\"],#table-of-contents-content a[aria-current=\"page\"]{font-weight:600!important}.dark #table-of-contents-content li.active>a,.dark #table-of-contents-content li[data-active=\"true\"]>a,.dark #table-of-contents-content a[aria-current=\"true\"],.dark #table-of-contents-content a[aria-current=\"location\"],.dark #table-of-contents-content a[aria-current=\"page\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #table-of-contents-content li.active::before,.dark #table-of-contents-content li[data-active=\"true\"]::before{background-color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents a[class*=\"text-primary\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important}.dark #content-area .eyebrow{color:var(--rdb-nav-active-fg-dark)!important}.dark [data-component-part=\"card-title\"],.dark [data-component-part=\"card-content\"]{color:var(--rdb-gray-300)!important}.dark [data-component-part=\"card-icon\"]>svg,.dark #card-link-arrow-icon{color:var(--rdb-gray-300)!important;background-color:var(--rdb-gray-300)!important}#navbar nav ul li>a.link{font-weight:700!important}#topbar-cta-button>a{font-weight:700!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{border-radius:var(--rdb-radius)!important;border:2px solid var(--rdb-gray-900)!important;font-weight:700!important;text-decoration:none!important;background:transparent!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important;background:color-mix(in srgb, var(--rdb-gray-900) 15%, transparent)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{color:var(--rdb-gray-300)!important;border-color:var(--rdb-gray-300)!important}.dark #topbar-cta-button>a{background:var(--rdb-nav-active-bg-dark)!important}.dark #topbar-cta-button>a span{color:var(--rdb-nav-active-fg-dark)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,.dark #navbar nav a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-200)!important;color:var(--rdb-gray-200)!important;background:color-mix(in srgb, var(--rdb-gray-300) 25%, transparent)!important}.dark [data-testid=\"api-playground-modal\"] .text-playground-input,.dark #content-area [id^=\"api-playground-\"] .text-playground-input{color:var(--rdb-gray-300)!important}.dark [data-testid=\"api-playground-modal\"] .text-playground-input::placeholder,.dark [data-testid=\"api-playground-modal\"] input.text-playground-input::-webkit-input-placeholder,.dark [data-testid=\"api-playground-modal\"] textarea.text-playground-input::-webkit-input-placeholder,.dark #content-area [id^=\"api-playground-\"] .text-playground-input::placeholder,.dark #content-area [id^=\"api-playground-\"] input.text-playground-input::placeholder,.dark #content-area [id^=\"api-playground-\"] textarea.text-playground-input::placeholder{color:var(--rdb-gray-300)!important;opacity:1!important}.dark [data-testid=\"api-playground-modal\"] select.text-playground-input,.dark #content-area [id^=\"api-playground-\"] select.text-playground-input{color:var(--rdb-gray-300)!important}.dark #content-area [id^=\"api-playground-\"] .text-primary,.dark #content-area [id^=\"api-playground-\"] .dark\\\\:text-primary-light,.dark #content-area [id^=\"response-\"] .text-primary,.dark #content-area [id^=\"response-\"] .dark\\\\:text-primary-light,.dark #content-area .param-head .text-primary,.dark #content-area .param-head .dark\\\\:text-primary-light{color:var(--rdb-nav-active-fg-dark)!important}.plan-comparison-tables table{table-layout:fixed}.plan-comparison-tables table :is(th,td){min-width:0;overflow-wrap:anywhere}.plan-comparison-tables table th:first-child{width:34%}"}],"page":{"pagePath":"api-reference/v2/vrm-lookup/look-up-a-uk-registration","slug":"/api-reference/v2/vrm-lookup/look-up-a-uk-registration","pageMetadata":{"title":"Look up a UK registration","description":"UK registrations only. The `uk` path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup.\n\nRequires a valid API key with `vdb_read`. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as `Authorization: Bearer \u003cAPI_KEY>`.\n\nSuccessful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts.\n\nEvery retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return `503 test_registration_unavailable`; they never trigger a provider call. An `Idempotency-Key` is scoped to the account and normalized plate; reusing it for a different plate returns `409`. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key.\n\nThe `engine` object follows the engine-details layout: use `engine.performance` for OEM data and `engine.tuning.stages` for tuned data. A matched engine includes the full account-visible catalog details and customisations.\n\nWithout a reliable match, known registration specifications fill the same fields, `engine.id` is `null`, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog.\n\nBroad registration attributes remain under `vehicle.details`. Power is metric horsepower (PS), torque is Nm.","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /vrm/uk/lookup","href":"/api-reference/v2/vrm-lookup/look-up-a-uk-registration","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"UK registrations only. The \", _jsx(_components.code, {\n children: \"uk\"\n }), \" path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Requires a valid API key with \", _jsx(_components.code, {\n children: \"vdb_read\"\n }), \". Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as \", _jsx(_components.code, {\n children: \"Authorization: Bearer \u003cAPI_KEY>\"\n }), \".\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Successful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Every retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return \", _jsx(_components.code, {\n children: \"503 test_registration_unavailable\"\n }), \"; they never trigger a provider call. An \", _jsx(_components.code, {\n children: \"Idempotency-Key\"\n }), \" is scoped to the account and normalized plate; reusing it for a different plate returns \", _jsx(_components.code, {\n children: \"409\"\n }), \". Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The \", _jsx(_components.code, {\n children: \"engine\"\n }), \" object follows the engine-details layout: use \", _jsx(_components.code, {\n children: \"engine.performance\"\n }), \" for OEM data and \", _jsx(_components.code, {\n children: \"engine.tuning.stages\"\n }), \" for tuned data. A matched engine includes the full account-visible catalog details and customisations.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Without a reliable match, known registration specifications fill the same fields, \", _jsx(_components.code, {\n children: \"engine.id\"\n }), \" is \", _jsx(_components.code, {\n children: \"null\"\n }), \", and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Broad registration attributes remain under \", _jsx(_components.code, {\n children: \"vehicle.details\"\n }), \". Power is metric horsepower (PS), torque is Nm.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Look up a UK registration","description":"UK registrations only. The `uk` path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup.\n\nRequires a valid API key with `vdb_read`. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as `Authorization: Bearer \u003cAPI_KEY>`.\n\nSuccessful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts.\n\nEvery retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return `503 test_registration_unavailable`; they never trigger a provider call. An `Idempotency-Key` is scoped to the account and normalized plate; reusing it for a different plate returns `409`. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key.\n\nThe `engine` object follows the engine-details layout: use `engine.performance` for OEM data and `engine.tuning.stages` for tuned data. A matched engine includes the full account-visible catalog details and customisations.\n\nWithout a reliable match, known registration specifications fill the same fields, `engine.id` is `null`, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog.\n\nBroad registration attributes remain under `vehicle.details`. Power is metric horsepower (PS), torque is Nm.","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /vrm/uk/lookup","href":"/api-reference/v2/vrm-lookup/look-up-a-uk-registration","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["VRM lookup"],"summary":"Look up a UK registration","operationId":"lookup_uk_vrm","description":"UK registrations only. The `uk` path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup.\n\nRequires a valid API key with `vdb_read`. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as `Authorization: Bearer \u003cAPI_KEY>`.\n\nSuccessful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts.\n\nEvery retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return `503 test_registration_unavailable`; they never trigger a provider call. An `Idempotency-Key` is scoped to the account and normalized plate; reusing it for a different plate returns `409`. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key.\n\nThe `engine` object follows the engine-details layout: use `engine.performance` for OEM data and `engine.tuning.stages` for tuned data. A matched engine includes the full account-visible catalog details and customisations.\n\nWithout a reliable match, known registration specifications fill the same fields, `engine.id` is `null`, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog.\n\nBroad registration attributes remain under `vehicle.details`. Power is metric horsepower (PS), torque is Nm.","parameters":["6f081d98-6370-46b3-b1c1-2d570391230a"],"requestBody":"254d7f17-6582-4382-af1c-0d02e337b3bb","responses":{"200":"a39df164-fa9d-445e-91fd-fb4f43a2471e","400":"c858cf39-ef13-490a-a03f-d203c10ab693","401":"2de5542f-517f-4611-901d-72b15b5f03d6","403":"655d9942-b6de-40ad-bdf5-e7817484b5ae","409":"d35b5075-fce3-4053-bef0-3380c4348fcb","415":"6a014d9a-188a-478d-a155-20cfd4455fda","429":"63862763-f8f4-439f-b2df-aebd5dc0a23e","503":"5cabc5ac-d086-4ccf-b6ba-2a9de7b568bf"},"security":["4280f774-fc9a-4ee2-b413-2a977b8d8a2e"],"method":"post","type":"path","servers":["1b9735ae-e90d-461d-9f84-c56b8a46a2ef"],"path":"/vrm/uk/lookup","baseUrlOptions":["https://api.remapdb.com/v2"],"title":"Look up a UK registration","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6f081d98-6370-46b3-b1c1-2d570391230a":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$","isRequired":true,"description":"Unique key shared by retries of this lookup, such as a UUID.","uniqueKey":"","typeLabel":"string"},"description":"Unique key shared by retries of this lookup, such as a UUID."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"vrm":{"type":"string","minLength":2,"maxLength":32,"example":"SA22NNB","isRequired":true,"uniqueKey":"vrm","typeLabel":"string"}},"required":["vrm"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"vrm":"SA22NNB"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"a39df164-fa9d-445e-91fd-fb4f43a2471e":{"description":"Matched, estimated, unavailable or vehicle_not_found result. A successful vehicle observation is billable even when matching or estimates are unavailable.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"lookup_id":{"type":"integer","format":"int64","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"lookup_id","typeLabel":"integer\u003cint64>"},"status":{"type":"string","enum":["matched","estimated","unavailable","vehicle_not_found"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"vehicle":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"make":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.make.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.make.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.make","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.model.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.model","typeLabel":"string | null"},"derivative":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.derivative.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.derivative.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.derivative","typeLabel":"string | null"},"series":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.series.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.series.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.series","typeLabel":"string | null"},"fuel":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.fuel.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.fuel.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.fuel","typeLabel":"string | null"},"powertrain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.powertrain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.powertrain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.powertrain","typeLabel":"string | null"},"aspiration":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.aspiration.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.aspiration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.aspiration","typeLabel":"string | null"},"engine_code":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.engine_code.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.engine_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.engine_code","typeLabel":"string | null"},"engine_code_source":{"oneOf":[{"type":"string","description":"Engine-code provenance: vehicle_codes, engine_description, or smmt_engine_description. Description-derived codes must be code-shaped and agree across available description fields; serial numbers and registration echoes are excluded. Upstream tool-match suggestions do not establish ECU/TCU identity.","isRequired":true,"uniqueKey":"vehicle.oneOf.0.engine_code_source.oneOf.0","typeLabel":"string"},{"type":"null","description":"Engine-code provenance: vehicle_codes, engine_description, or smmt_engine_description. Description-derived codes must be code-shaped and agree across available description fields; serial numbers and registration echoes are excluded. Upstream tool-match suggestions do not establish ECU/TCU identity.","isRequired":true,"uniqueKey":"vehicle.oneOf.0.engine_code_source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.engine_code_source","typeLabel":"string | null"},"derivative_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.derivative_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.derivative_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.derivative_id","typeLabel":"string | null"},"vrm":{"type":"string","isRequired":true,"uniqueKey":"vehicle.oneOf.0.vrm","typeLabel":"string"},"vehicle_type":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"vehicle.oneOf.0.vehicle_type.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.vehicle_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.vehicle_type","typeLabel":"integer | null"},"year":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"vehicle.oneOf.0.year.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.year.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.year","typeLabel":"integer | null"},"capacity_cc":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.capacity_cc.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.capacity_cc.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.capacity_cc","typeLabel":"number | null"},"power_kw":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_kw.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_kw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_kw","typeLabel":"number | null"},"power_ps":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_ps.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_ps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_ps","typeLabel":"number | null"},"power_bhp":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_bhp.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_bhp.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.power_bhp","typeLabel":"number | null"},"torque_nm":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.torque_nm.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.torque_nm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.torque_nm","typeLabel":"number | null"},"reported_power":{"type":"object","additionalProperties":false,"properties":{"kw":{"oneOf":[{"type":"number","uniqueKey":"vehicle.oneOf.0.reported_power.kw.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"vehicle.oneOf.0.reported_power.kw.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.reported_power.kw","typeLabel":"number | null"},"ps":{"oneOf":[{"type":"number","uniqueKey":"vehicle.oneOf.0.reported_power.ps.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"vehicle.oneOf.0.reported_power.ps.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.reported_power.ps","typeLabel":"number | null"},"bhp":{"oneOf":[{"type":"number","uniqueKey":"vehicle.oneOf.0.reported_power.bhp.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"vehicle.oneOf.0.reported_power.bhp.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.reported_power.bhp","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"vehicle.oneOf.0.reported_power","typeLabel":"object"},"details":{"type":"object","additionalProperties":true,"description":"Available vehicle-specific attributes in snake_case, grouped independently of the upstream response envelope. Values, explicit nulls, booleans, lists and units are preserved. Missing sections are omitted, and additional vehicle fields may appear. Credentials, service identity/provenance, billing, request diagnostics and full VINs are excluded. Cached observations supply these details without another external lookup.","properties":{"identification":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Registration, registration dates, manufacture dates, engine serial number, VIN suffix and licensing attributes. Full VINs remain internal.","uniqueKey":"vehicle.oneOf.0.details.identification.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Registration, registration dates, manufacture dates, engine serial number, VIN suffix and licensing attributes. Full VINs remain internal.","uniqueKey":"vehicle.oneOf.0.details.identification.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.identification","typeLabel":"object | null"},"status":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Import/export/scrap status and vehicle excise duty details.","uniqueKey":"vehicle.oneOf.0.details.status.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Import/export/scrap status and vehicle excise duty details.","uniqueKey":"vehicle.oneOf.0.details.status.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.status","typeLabel":"object | null"},"history":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Colour history, keeper changes, plate changes and V5C issue dates.","uniqueKey":"vehicle.oneOf.0.details.history.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Colour history, keeper changes, plate changes and V5C issue dates.","uniqueKey":"vehicle.oneOf.0.details.history.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.history","typeLabel":"object | null"},"technical":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Recorded technical attributes including seats, mass, towing limits and capacity.","uniqueKey":"vehicle.oneOf.0.details.technical.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Recorded technical attributes including seats, mass, towing limits and capacity.","uniqueKey":"vehicle.oneOf.0.details.technical.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.technical","typeLabel":"object | null"},"model":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Make, range, model, derivative, series and model production dates.","uniqueKey":"vehicle.oneOf.0.details.model.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Make, range, model, derivative, series and model production dates.","uniqueKey":"vehicle.oneOf.0.details.model.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.model","typeLabel":"object | null"},"classification":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Vehicle class, taxation class and type approval.","uniqueKey":"vehicle.oneOf.0.details.classification.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Vehicle class, taxation class and type approval.","uniqueKey":"vehicle.oneOf.0.details.classification.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.classification","typeLabel":"object | null"},"vehicle_codes":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Engine code and derivative reference, when supplied.","uniqueKey":"vehicle.oneOf.0.details.vehicle_codes.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Engine code and derivative reference, when supplied.","uniqueKey":"vehicle.oneOf.0.details.vehicle_codes.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.vehicle_codes","typeLabel":"object | null"},"powertrain":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Combustion engine, EV/hybrid, battery, charging and transmission attributes.","uniqueKey":"vehicle.oneOf.0.details.powertrain.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Combustion engine, EV/hybrid, battery, charging and transmission attributes.","uniqueKey":"vehicle.oneOf.0.details.powertrain.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.powertrain","typeLabel":"object | null"},"body_details":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Body configuration, doors and other body attributes.","uniqueKey":"vehicle.oneOf.0.details.body_details.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Body configuration, doors and other body attributes.","uniqueKey":"vehicle.oneOf.0.details.body_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.body_details","typeLabel":"object | null"},"dimensions":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Dimensions in the units indicated by the field names.","uniqueKey":"vehicle.oneOf.0.details.dimensions.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Dimensions in the units indicated by the field names.","uniqueKey":"vehicle.oneOf.0.details.dimensions.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.dimensions","typeLabel":"object | null"},"weights":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Vehicle and towing weights in the indicated units.","uniqueKey":"vehicle.oneOf.0.details.weights.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Vehicle and towing weights in the indicated units.","uniqueKey":"vehicle.oneOf.0.details.weights.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.weights","typeLabel":"object | null"},"performance":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Original power, torque, acceleration, top speed and fuel economy values and units.","uniqueKey":"vehicle.oneOf.0.details.performance.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Original power, torque, acceleration, top speed and fuel economy values and units.","uniqueKey":"vehicle.oneOf.0.details.performance.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.performance","typeLabel":"object | null"},"emissions":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Emissions standards, CO2 and sound levels.","uniqueKey":"vehicle.oneOf.0.details.emissions.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Emissions standards, CO2 and sound levels.","uniqueKey":"vehicle.oneOf.0.details.emissions.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.emissions","typeLabel":"object | null"},"safety":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Safety and crash-test ratings.","uniqueKey":"vehicle.oneOf.0.details.safety.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Safety and crash-test ratings.","uniqueKey":"vehicle.oneOf.0.details.safety.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.safety","typeLabel":"object | null"},"additional_information":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Warranty and other vehicle attributes.","uniqueKey":"vehicle.oneOf.0.details.additional_information.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Warranty and other vehicle attributes.","uniqueKey":"vehicle.oneOf.0.details.additional_information.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.details.additional_information","typeLabel":"object | null"}},"example":{"identification":{"vrm":"SA22NNB","date_first_registered":"2022-03-01T00:00:00","year_of_manufacture":2022},"history":{"colour_details":{"current_colour":"BLUE","number_of_colour_changes":0}},"status":{"is_imported":false,"is_scrapped":false},"powertrain":{"transmission":{"transmission_type":"Automatic","number_of_gears":8}},"performance":{"power":{"kw":131,"ps":178.2,"bhp":175.7},"torque":{"nm":280}}},"isRequired":true,"uniqueKey":"vehicle.oneOf.0.details","typeLabel":"object"},"combustion_fuel":{"oneOf":[{"type":"string","enum":["petrol","diesel",null],"uniqueKey":"vehicle.oneOf.0.combustion_fuel.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["petrol","diesel",null],"uniqueKey":"vehicle.oneOf.0.combustion_fuel.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.combustion_fuel","typeLabel":"enum\u003cstring> | null"},"powertrain_type":{"oneOf":[{"type":"string","description":"Reported powertrain subtype, for example PHEV, HEV, MHEV, ICE or BEV.","uniqueKey":"vehicle.oneOf.0.powertrain_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Reported powertrain subtype, for example PHEV, HEV, MHEV, ICE or BEV.","uniqueKey":"vehicle.oneOf.0.powertrain_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.powertrain_type","typeLabel":"string | null"},"performance_version":{"type":"integer","uniqueKey":"vehicle.oneOf.0.performance_version","typeLabel":"integer"},"performance_components":{"type":"object","additionalProperties":false,"properties":{"combustion":{"type":"object","additionalProperties":false,"properties":{"power_kw":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_kw.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_kw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_kw","typeLabel":"number | null"},"power_ps":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_ps.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_ps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_ps","typeLabel":"number | null"},"power_bhp":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_bhp.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_bhp.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.power_bhp","typeLabel":"number | null"},"torque_nm":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.torque_nm.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.torque_nm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.torque_nm","typeLabel":"number | null"},"issues":{"type":"array","items":{"type":"string","enum":["conflicting_power","conflicting_torque","conflicting_combustion_fuel"],"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.issues.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.issues","typeLabel":"enum\u003cstring>[]"},"fuel":{"oneOf":[{"type":"string","enum":["petrol","diesel",null],"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.fuel.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["petrol","diesel",null],"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.fuel.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.fuel","typeLabel":"enum\u003cstring> | null"},"aspiration":{"oneOf":[{"type":"string","enum":["turbo","na",null],"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.aspiration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["turbo","na",null],"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.aspiration.oneOf.1","typeLabel":"null"}],"uniqueKey":"vehicle.oneOf.0.performance_components.combustion.aspiration","typeLabel":"enum\u003cstring> | null"}},"required":["power_kw","power_ps","power_bhp","torque_nm","issues"],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combustion","typeLabel":"object"},"electric_motors":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"power_kw":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_kw.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_kw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_kw","typeLabel":"number | null"},"power_ps":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_ps.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_ps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_ps","typeLabel":"number | null"},"power_bhp":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_bhp.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_bhp.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].power_bhp","typeLabel":"number | null"},"torque_nm":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].torque_nm.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].torque_nm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].torque_nm","typeLabel":"number | null"},"issues":{"type":"array","items":{"type":"string","enum":["conflicting_power","conflicting_torque","conflicting_combustion_fuel"],"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].issues.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX].issues","typeLabel":"enum\u003cstring>[]"}},"required":["power_kw","power_ps","power_bhp","torque_nm","issues"],"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.electric_motors","typeLabel":"object[]"},"combined":{"type":"object","additionalProperties":false,"properties":{"power_kw":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_kw.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_kw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_kw","typeLabel":"number | null"},"power_ps":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_ps.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_ps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_ps","typeLabel":"number | null"},"power_bhp":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_bhp.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_bhp.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.power_bhp","typeLabel":"number | null"},"torque_nm":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.torque_nm.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.torque_nm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.torque_nm","typeLabel":"number | null"},"issues":{"type":"array","items":{"type":"string","enum":["conflicting_power","conflicting_torque","conflicting_combustion_fuel"],"uniqueKey":"vehicle.oneOf.0.performance_components.combined.issues.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined.issues","typeLabel":"enum\u003cstring>[]"}},"required":["power_kw","power_ps","power_bhp","torque_nm","issues"],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.combined","typeLabel":"object"},"unattributed":{"type":"object","additionalProperties":false,"properties":{"power_kw":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_kw.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_kw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_kw","typeLabel":"number | null"},"power_ps":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_ps.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_ps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_ps","typeLabel":"number | null"},"power_bhp":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_bhp.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_bhp.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.power_bhp","typeLabel":"number | null"},"torque_nm":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.torque_nm.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.torque_nm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.torque_nm","typeLabel":"number | null"},"issues":{"type":"array","items":{"type":"string","enum":["conflicting_power","conflicting_torque","conflicting_combustion_fuel"],"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.issues.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed.issues","typeLabel":"enum\u003cstring>[]"}},"required":["power_kw","power_ps","power_bhp","torque_nm","issues"],"isRequired":true,"uniqueKey":"vehicle.oneOf.0.performance_components.unattributed","typeLabel":"object"}},"required":["combustion","electric_motors","combined","unattributed"],"description":"Component-specific maxima. Combustion values require explicit engine attribution for hybrids. Electric motors are separate entries, never summed. Combined values require explicit system attribution and are never calculated. Generic hybrid ModelDetails performance is unattributed: it may describe the whole vehicle, a component, or mixed figures and is not a tuning baseline. Conflicting measurements are null with issues. No component attribution is inferred from numerical agreement.","uniqueKey":"vehicle.oneOf.0.performance_components","typeLabel":"object"}},"required":["make","model","derivative","series","fuel","powertrain","aspiration","engine_code","engine_code_source","derivative_id","vrm","vehicle_type","year","capacity_cc","power_kw","power_ps","power_bhp","torque_nm","reported_power","details"],"description":"Normalized vehicle observation and comprehensive registration-specific details. Power is converted with distinct PS and BHP factors; reported_power preserves received values. Full VINs remain internal. Null means evidence is missing. Service identity, credentials, billing and request metadata are never returned. Hybrid top-level power and torque are null; use performance_components with its explicit attribution. Original generic values remain in reported_power and details and must not be treated as combustion specifications.","isRequired":true,"uniqueKey":"vehicle.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"properties":{"make":{"oneOf":[{"type":"string"},{"type":"null"}]},"model":{"oneOf":[{"type":"string"},{"type":"null"}]},"derivative":{"oneOf":[{"type":"string"},{"type":"null"}]},"series":{"oneOf":[{"type":"string"},{"type":"null"}]},"fuel":{"oneOf":[{"type":"string"},{"type":"null"}]},"powertrain":{"oneOf":[{"type":"string"},{"type":"null"}]},"aspiration":{"oneOf":[{"type":"string"},{"type":"null"}]},"engine_code":{"oneOf":[{"type":"string"},{"type":"null"}]},"engine_code_source":{"oneOf":[{"type":"string","description":"Engine-code provenance: vehicle_codes, engine_description, or smmt_engine_description. Description-derived codes must be code-shaped and agree across available description fields; serial numbers and registration echoes are excluded. Upstream tool-match suggestions do not establish ECU/TCU identity."},{"type":"null","description":"Engine-code provenance: vehicle_codes, engine_description, or smmt_engine_description. Description-derived codes must be code-shaped and agree across available description fields; serial numbers and registration echoes are excluded. Upstream tool-match suggestions do not establish ECU/TCU identity."}]},"derivative_id":{"oneOf":[{"type":"string"},{"type":"null"}]},"vrm":{"type":"string"},"vehicle_type":{"oneOf":[{"type":"integer"},{"type":"null"}]},"year":{"oneOf":[{"type":"integer"},{"type":"null"}]},"capacity_cc":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_kw":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_ps":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_bhp":{"oneOf":[{"type":"number"},{"type":"null"}]},"torque_nm":{"oneOf":[{"type":"number"},{"type":"null"}]},"reported_power":{"type":"object","additionalProperties":false,"properties":{"kw":{"oneOf":[{"type":"number"},{"type":"null"}]},"ps":{"oneOf":[{"type":"number"},{"type":"null"}]},"bhp":{"oneOf":[{"type":"number"},{"type":"null"}]}}},"details":{"type":"object","additionalProperties":true,"description":"Available vehicle-specific attributes in snake_case, grouped independently of the upstream response envelope. Values, explicit nulls, booleans, lists and units are preserved. Missing sections are omitted, and additional vehicle fields may appear. Credentials, service identity/provenance, billing, request diagnostics and full VINs are excluded. Cached observations supply these details without another external lookup.","properties":{"identification":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Registration, registration dates, manufacture dates, engine serial number, VIN suffix and licensing attributes. Full VINs remain internal."},{"type":"null","additionalProperties":true,"description":"Registration, registration dates, manufacture dates, engine serial number, VIN suffix and licensing attributes. Full VINs remain internal."}]},"status":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Import/export/scrap status and vehicle excise duty details."},{"type":"null","additionalProperties":true,"description":"Import/export/scrap status and vehicle excise duty details."}]},"history":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Colour history, keeper changes, plate changes and V5C issue dates."},{"type":"null","additionalProperties":true,"description":"Colour history, keeper changes, plate changes and V5C issue dates."}]},"technical":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Recorded technical attributes including seats, mass, towing limits and capacity."},{"type":"null","additionalProperties":true,"description":"Recorded technical attributes including seats, mass, towing limits and capacity."}]},"model":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Make, range, model, derivative, series and model production dates."},{"type":"null","additionalProperties":true,"description":"Make, range, model, derivative, series and model production dates."}]},"classification":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Vehicle class, taxation class and type approval."},{"type":"null","additionalProperties":true,"description":"Vehicle class, taxation class and type approval."}]},"vehicle_codes":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Engine code and derivative reference, when supplied."},{"type":"null","additionalProperties":true,"description":"Engine code and derivative reference, when supplied."}]},"powertrain":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Combustion engine, EV/hybrid, battery, charging and transmission attributes."},{"type":"null","additionalProperties":true,"description":"Combustion engine, EV/hybrid, battery, charging and transmission attributes."}]},"body_details":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Body configuration, doors and other body attributes."},{"type":"null","additionalProperties":true,"description":"Body configuration, doors and other body attributes."}]},"dimensions":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Dimensions in the units indicated by the field names."},{"type":"null","additionalProperties":true,"description":"Dimensions in the units indicated by the field names."}]},"weights":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Vehicle and towing weights in the indicated units."},{"type":"null","additionalProperties":true,"description":"Vehicle and towing weights in the indicated units."}]},"performance":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Original power, torque, acceleration, top speed and fuel economy values and units."},{"type":"null","additionalProperties":true,"description":"Original power, torque, acceleration, top speed and fuel economy values and units."}]},"emissions":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Emissions standards, CO2 and sound levels."},{"type":"null","additionalProperties":true,"description":"Emissions standards, CO2 and sound levels."}]},"safety":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Safety and crash-test ratings."},{"type":"null","additionalProperties":true,"description":"Safety and crash-test ratings."}]},"additional_information":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Warranty and other vehicle attributes."},{"type":"null","additionalProperties":true,"description":"Warranty and other vehicle attributes."}]}},"example":{"identification":{"vrm":"SA22NNB","date_first_registered":"2022-03-01T00:00:00","year_of_manufacture":2022},"history":{"colour_details":{"current_colour":"BLUE","number_of_colour_changes":0}},"status":{"is_imported":false,"is_scrapped":false},"powertrain":{"transmission":{"transmission_type":"Automatic","number_of_gears":8}},"performance":{"power":{"kw":131,"ps":178.2,"bhp":175.7},"torque":{"nm":280}}}},"combustion_fuel":{"oneOf":[{"type":"string","enum":["petrol","diesel",null]},{"type":"null","enum":["petrol","diesel",null]}]},"powertrain_type":{"oneOf":[{"type":"string","description":"Reported powertrain subtype, for example PHEV, HEV, MHEV, ICE or BEV."},{"type":"null","description":"Reported powertrain subtype, for example PHEV, HEV, MHEV, ICE or BEV."}]},"performance_version":{"type":"integer"},"performance_components":{"type":"object","additionalProperties":false,"properties":{"combustion":{"type":"object","additionalProperties":false,"properties":{"power_kw":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_ps":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_bhp":{"oneOf":[{"type":"number"},{"type":"null"}]},"torque_nm":{"oneOf":[{"type":"number"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"string","enum":["conflicting_power","conflicting_torque","conflicting_combustion_fuel"]}},"fuel":{"oneOf":[{"type":"string","enum":["petrol","diesel",null]},{"type":"null","enum":["petrol","diesel",null]}]},"aspiration":{"oneOf":[{"type":"string","enum":["turbo","na",null]},{"type":"null","enum":["turbo","na",null]}]}},"required":["power_kw","power_ps","power_bhp","torque_nm","issues"]},"electric_motors":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"power_kw":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_ps":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_bhp":{"oneOf":[{"type":"number"},{"type":"null"}]},"torque_nm":{"oneOf":[{"type":"number"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"string","enum":["conflicting_power","conflicting_torque","conflicting_combustion_fuel"]}}},"required":["power_kw","power_ps","power_bhp","torque_nm","issues"]}},"combined":{"type":"object","additionalProperties":false,"properties":{"power_kw":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_ps":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_bhp":{"oneOf":[{"type":"number"},{"type":"null"}]},"torque_nm":{"oneOf":[{"type":"number"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"string","enum":["conflicting_power","conflicting_torque","conflicting_combustion_fuel"]}}},"required":["power_kw","power_ps","power_bhp","torque_nm","issues"]},"unattributed":{"type":"object","additionalProperties":false,"properties":{"power_kw":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_ps":{"oneOf":[{"type":"number"},{"type":"null"}]},"power_bhp":{"oneOf":[{"type":"number"},{"type":"null"}]},"torque_nm":{"oneOf":[{"type":"number"},{"type":"null"}]},"issues":{"type":"array","items":{"type":"string","enum":["conflicting_power","conflicting_torque","conflicting_combustion_fuel"]}}},"required":["power_kw","power_ps","power_bhp","torque_nm","issues"]}},"required":["combustion","electric_motors","combined","unattributed"],"description":"Component-specific maxima. Combustion values require explicit engine attribution for hybrids. Electric motors are separate entries, never summed. Combined values require explicit system attribution and are never calculated. Generic hybrid ModelDetails performance is unattributed: it may describe the whole vehicle, a component, or mixed figures and is not a tuning baseline. Conflicting measurements are null with issues. No component attribution is inferred from numerical agreement."}},"required":["make","model","derivative","series","fuel","powertrain","aspiration","engine_code","engine_code_source","derivative_id","vrm","vehicle_type","year","capacity_cc","power_kw","power_ps","power_bhp","torque_nm","reported_power","details"],"description":"Normalized vehicle observation and comprehensive registration-specific details. Power is converted with distinct PS and BHP factors; reported_power preserves received values. Full VINs remain internal. Null means evidence is missing. Service identity, credentials, billing and request metadata are never returned. Hybrid top-level power and torque are null; use performance_components with its explicit attribution. Original generic values remain in reported_power and details and must not be treated as combustion specifications.","isRequired":true,"uniqueKey":"vehicle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vehicle","typeLabel":"object | null"},"engine":{"oneOf":[{"type":"object","additionalProperties":false,"description":"Engine-details layout, matching GET /engines/{engine_id}, plus lookup provenance. Matched engines include the visible catalog details and account customisations. Unmatched vehicles include known registration specifications and available estimated stages; catalog IDs and unknown facts are null, unsupported equipment is empty; illustrative combustion curves are generated only with reliable component power/torque, known fuel/aspiration and a valid unique template. The whole object is null for a missing vehicle or a catalog visibility restriction. An unavailable estimate may still return known engine details.","properties":{"capacity":{"oneOf":[{"description":"Engine capacity in cubic cm.","example":1800,"type":"integer","isRequired":true,"uniqueKey":"engine.oneOf.0.capacity.oneOf.0","typeLabel":"integer"},{"description":"Engine capacity in cubic cm.","example":1800,"type":"null","isRequired":true,"uniqueKey":"engine.oneOf.0.capacity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.capacity","typeLabel":"integer | null"},"cylinders":{"oneOf":[{"description":"Number of cylinders.","example":4,"type":"integer","isRequired":true,"uniqueKey":"engine.oneOf.0.cylinders.oneOf.0","typeLabel":"integer"},{"description":"Number of cylinders.","example":4,"type":"null","isRequired":true,"uniqueKey":"engine.oneOf.0.cylinders.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.cylinders","typeLabel":"integer | null"},"ecus":{"description":"List of ECU's used in this engine.","items":{"additionalProperties":false,"description":"ECU object","properties":{"manufacturer":{"description":"Manufacturer.","example":"Bosch","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"ego5g0wgjbx5z"},"uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].manufacturer","typeLabel":"string"},"name":{"description":"Name.","example":"EDC17CP54","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].name","typeLabel":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers.","uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].id","typeLabel":"integer\u003cint64>"},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer.","uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].origin","typeLabel":"enum\u003cstring>"},"code":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].code","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].description","typeLabel":"string | null"},"model":{"type":"string","description":"Equipment model; retained for existing API clients.","uniqueKey":"engine.oneOf.0.ecus.items.[INDEX].model","typeLabel":"string"}},"title":"ECU","type":"object","x-examples":{"Bosch EDC17":{"manufacturer":"Bosch","name":"EDC17CP54"}},"uniqueKey":"engine.oneOf.0.ecus.items.[INDEX]","typeLabel":"ECU · object"},"maxItems":1000,"type":"array","isRequired":true,"uniqueKey":"engine.oneOf.0.ecus","typeLabel":"ECU · object[]"},"engine_code":{"oneOf":[{"description":"Engine code.","example":"XYZ","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","isRequired":true,"uniqueKey":"engine.oneOf.0.engine_code.oneOf.0","typeLabel":"string"},{"description":"Engine code.","example":"XYZ","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null","isRequired":true,"uniqueKey":"engine.oneOf.0.engine_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.engine_code","typeLabel":"string | null"},"engine_type":{"oneOf":[{"description":"Engine type.","example":"Petrol","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","isRequired":true,"uniqueKey":"engine.oneOf.0.engine_type.oneOf.0","typeLabel":"string"},{"description":"Engine type.","example":"Petrol","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null","isRequired":true,"uniqueKey":"engine.oneOf.0.engine_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.engine_type","typeLabel":"string | null"},"fuel":{"oneOf":[{"description":"Name of the fuel.","example":"Petrol","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","isRequired":true,"uniqueKey":"engine.oneOf.0.fuel.oneOf.0","typeLabel":"string"},{"description":"Name of the fuel.","example":"Petrol","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null","isRequired":true,"uniqueKey":"engine.oneOf.0.fuel.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.fuel","typeLabel":"string | null"},"id":{"oneOf":[{"description":"Catalog engine ID when matched; null for registration-derived data. provisional_id is a separate review reference and must never be used with /engines/{engine_id}.","example":1234,"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"engine.oneOf.0.id.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"Catalog engine ID when matched; null for registration-derived data. provisional_id is a separate review reference and must never be used with /engines/{engine_id}.","example":1234,"type":"null","format":"int64","minimum":1,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"engine.oneOf.0.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.id","typeLabel":"integer\u003cint64> | null"},"name":{"oneOf":[{"description":"Customised catalog name when matched; otherwise a description assembled from the registration make and derivative/model.","example":"1.8i 125hp 170Nm","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","isRequired":true,"uniqueKey":"engine.oneOf.0.name.oneOf.0","typeLabel":"string"},{"description":"Customised catalog name when matched; otherwise a description assembled from the registration make and derivative/model.","example":"1.8i 125hp 170Nm","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null","isRequired":true,"uniqueKey":"engine.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.name","typeLabel":"string | null"},"performance":{"type":"object","additionalProperties":false,"description":"OEM engine-details layout. Matched catalog behavior is unchanged. Registration combustion power/torque are component-specific; generic hybrid and electric-motor figures never fill missing combustion maxima. Speed and acceleration, if present, remain vehicle-level observations. Dyno curves are illustrative template output, never measurements; missing or conflicting component inputs or unavailable templates leave arrays empty.","properties":{"power":{"oneOf":[{"type":"number","description":"Metric horsepower (PS). OEM registration values retain their accuracy; estimated stage outputs use policy rounding.","isRequired":true,"uniqueKey":"engine.oneOf.0.performance.power.oneOf.0","typeLabel":"number"},{"type":"null","description":"Metric horsepower (PS). OEM registration values retain their accuracy; estimated stage outputs use policy rounding.","isRequired":true,"uniqueKey":"engine.oneOf.0.performance.power.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.performance.power","typeLabel":"number | null"},"torque":{"oneOf":[{"type":"number","description":"Torque in Nm.","isRequired":true,"uniqueKey":"engine.oneOf.0.performance.torque.oneOf.0","typeLabel":"number"},{"type":"null","description":"Torque in Nm.","isRequired":true,"uniqueKey":"engine.oneOf.0.performance.torque.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.performance.torque","typeLabel":"number | null"},"dyno_values":{"oneOf":[{"additionalProperties":false,"description":"Dyno object","properties":{"hp":{"description":"HP values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"p93ihoykl0ya1"},"uniqueKey":"engine.oneOf.0.performance.dyno_values.oneOf.0.hp.items.[INDEX]","typeLabel":"integer"},"maxItems":1000,"type":"array","x-stoplight":{"id":"vd6hysqxr0wx8"},"uniqueKey":"engine.oneOf.0.performance.dyno_values.oneOf.0.hp","typeLabel":"integer[]"},"nm":{"description":"Nm values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"6fkv9wbg7h04g"},"uniqueKey":"engine.oneOf.0.performance.dyno_values.oneOf.0.nm.items.[INDEX]","typeLabel":"integer"},"maxItems":1000,"type":"array","x-stoplight":{"id":"4jpbgqaf9x9yh"},"uniqueKey":"engine.oneOf.0.performance.dyno_values.oneOf.0.nm","typeLabel":"integer[]"},"rpm":{"description":"RPM values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"wlvp55ibfn59e"},"uniqueKey":"engine.oneOf.0.performance.dyno_values.oneOf.0.rpm.items.[INDEX]","typeLabel":"integer"},"maxItems":1000,"type":"array","uniqueKey":"engine.oneOf.0.performance.dyno_values.oneOf.0.rpm","typeLabel":"integer[]"}},"title":"Dyno metadata","type":"object","x-examples":{"Example 1":{"hp":[0,49,87,112,135,140,112,0,0],"nm":[0,238,243,238,233,205,150,0,0],"rpm":[1000,2000,3000,4000,5000,6000,7000,8000,9000]}},"isRequired":true,"uniqueKey":"engine.oneOf.0.performance.dyno_values.oneOf.0","typeLabel":"Dyno metadata · object"},{"additionalProperties":false,"description":"Dyno object","properties":{"hp":{"description":"HP values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"p93ihoykl0ya1"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"vd6hysqxr0wx8"}},"nm":{"description":"Nm values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"6fkv9wbg7h04g"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"4jpbgqaf9x9yh"}},"rpm":{"description":"RPM values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"wlvp55ibfn59e"}},"maxItems":1000,"type":"array"}},"title":"Dyno metadata","type":"null","x-examples":{"Example 1":{"hp":[0,49,87,112,135,140,112,0,0],"nm":[0,238,243,238,233,205,150,0,0],"rpm":[1000,2000,3000,4000,5000,6000,7000,8000,9000]}},"isRequired":true,"uniqueKey":"engine.oneOf.0.performance.dyno_values.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.performance.dyno_values","typeLabel":"Dyno metadata · object | null"},"power_kw":{"oneOf":[{"type":"number","description":"Power in kW, provided for registration-derived OEM and estimated-stage performance.","uniqueKey":"engine.oneOf.0.performance.power_kw.oneOf.0","typeLabel":"number"},{"type":"null","description":"Power in kW, provided for registration-derived OEM and estimated-stage performance.","uniqueKey":"engine.oneOf.0.performance.power_kw.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.performance.power_kw","typeLabel":"number | null"},"power_bhp":{"oneOf":[{"type":"number","description":"Brake horsepower, provided for registration-derived OEM performance when known; distinct from PS.","uniqueKey":"engine.oneOf.0.performance.power_bhp.oneOf.0","typeLabel":"number"},{"type":"null","description":"Brake horsepower, provided for registration-derived OEM performance when known; distinct from PS.","uniqueKey":"engine.oneOf.0.performance.power_bhp.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.performance.power_bhp","typeLabel":"number | null"},"top_speed":{"oneOf":[{"type":"number","description":"Maximum speed in km/h when known. Estimates do not predict this value.","uniqueKey":"engine.oneOf.0.performance.top_speed.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum speed in km/h when known. Estimates do not predict this value.","uniqueKey":"engine.oneOf.0.performance.top_speed.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.performance.top_speed","typeLabel":"number | null"},"zero_to_hundred":{"oneOf":[{"type":"number","description":"0-100 km/h acceleration in seconds when known. Estimates do not predict this value.","uniqueKey":"engine.oneOf.0.performance.zero_to_hundred.oneOf.0","typeLabel":"number"},{"type":"null","description":"0-100 km/h acceleration in seconds when known. Estimates do not predict this value.","uniqueKey":"engine.oneOf.0.performance.zero_to_hundred.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.performance.zero_to_hundred","typeLabel":"number | null"},"dyno_source":{"oneOf":[{"type":"string","enum":["illustrative",null],"description":"Registration-only curve provenance. Null when no curve can be generated. Matched catalog responses omit this field.","uniqueKey":"engine.oneOf.0.performance.dyno_source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["illustrative",null],"description":"Registration-only curve provenance. Null when no curve can be generated. Matched catalog responses omit this field.","uniqueKey":"engine.oneOf.0.performance.dyno_source.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.performance.dyno_source","typeLabel":"enum\u003cstring> | null"}},"required":["power","torque","dyno_values"],"isRequired":true,"uniqueKey":"engine.oneOf.0.performance","typeLabel":"object"},"slug":{"oneOf":[{"description":"URL-friendly name (slug).","example":"1-8i-125hp-170nm","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","isRequired":true,"uniqueKey":"engine.oneOf.0.slug.oneOf.0","typeLabel":"string"},{"description":"URL-friendly name (slug).","example":"1-8i-125hp-170nm","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null","isRequired":true,"uniqueKey":"engine.oneOf.0.slug.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.slug","typeLabel":"string | null"},"tcus":{"description":"List of TCU's used in this engine.","items":{"additionalProperties":false,"description":"TCU object","properties":{"manufacturer":{"description":"Manufacturer.","example":"ZF","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].manufacturer","typeLabel":"string"},"name":{"description":"Name.","example":"8HP","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].name","typeLabel":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers.","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].id","typeLabel":"integer\u003cint64>"},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer.","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].origin","typeLabel":"enum\u003cstring>"},"code":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].code","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].description","typeLabel":"string | null"},"model":{"type":"string","description":"Equipment model; retained for existing API clients.","uniqueKey":"engine.oneOf.0.tcus.items.[INDEX].model","typeLabel":"string"}},"title":"TCU","type":"object","x-examples":{"ZF 8HP":{"manufacturer":"ZF","name":"8HP"}},"uniqueKey":"engine.oneOf.0.tcus.items.[INDEX]","typeLabel":"TCU · object"},"maxItems":1000,"type":"array","isRequired":true,"uniqueKey":"engine.oneOf.0.tcus","typeLabel":"TCU · object[]"},"tuning":{"type":"object","additionalProperties":false,"description":"Account-visible tuning data for a matched engine; otherwise empty equipment/options lists and available estimated stages.","properties":{"options":{"description":"Available remap options for this engine.","items":{"additionalProperties":false,"description":"Tuning option object","properties":{"description":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].description","typeLabel":"string | null"},"name":{"description":"Name.","example":"EGR","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].name","typeLabel":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers.","uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].id","typeLabel":"integer\u003cint64>"},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer.","uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].origin","typeLabel":"enum\u003cstring>"},"code":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX].code","typeLabel":"string | null"}},"title":"Option","type":"object","x-examples":{"EGR":{"description":"Removal of EGR","name":"EGR"}},"uniqueKey":"engine.oneOf.0.tuning.options.items.[INDEX]","typeLabel":"Option · object"},"maxItems":1000,"type":"array","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.options","typeLabel":"Option · object[]"},"read_tools":{"description":"List with the tuning tools which can be used to read this engine.","items":{"additionalProperties":false,"description":"Read Tool object","properties":{"manufacturer":{"description":"Manufacturer.","example":"Alientech","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"ene9p2f5occpc"},"uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].manufacturer","typeLabel":"string"},"name":{"description":"Name.","example":"KESS3","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].name","typeLabel":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers.","uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].id","typeLabel":"integer\u003cint64>"},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer.","uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].origin","typeLabel":"enum\u003cstring>"},"code":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].code","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX].description","typeLabel":"string | null"}},"title":"Read Tool","type":"object","x-examples":{"Alientech KESS3":{"manufacturer":"Alientech","name":"KESS3"}},"uniqueKey":"engine.oneOf.0.tuning.read_tools.items.[INDEX]","typeLabel":"Read Tool · object"},"maxItems":1000,"type":"array","x-stoplight":{"id":"lb5q8g6onza8o"},"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.read_tools","typeLabel":"Read Tool · object[]"},"stages":{"description":"List with Remap/Tuning Stages.","items":{"type":"object","additionalProperties":false,"description":"Tuning stage in the engine-details layout with explicit provenance. Estimates currently include Stage 1 and Stage 2, rounded to whole PS, kW and Nm. Estimates have null catalog IDs, no inferred modifications, no speed/acceleration predictions and optional illustrative combustion-only curves.","properties":{"modifications_required":{"oneOf":[{"description":"Modifications needed.","example":"Aftermarket intercooler and exhaust required.","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"nxjtpmqu6xw08"},"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].modifications_required.oneOf.0","typeLabel":"string"},{"description":"Modifications needed.","example":"Aftermarket intercooler and exhaust required.","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null","x-stoplight":{"id":"nxjtpmqu6xw08"},"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].modifications_required.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].modifications_required","typeLabel":"string | null"},"performance":{"type":"object","additionalProperties":false,"description":"Catalog or estimated stage performance. Calculated values are not measured dyno data.","properties":{"power":{"oneOf":[{"type":"number","description":"Metric horsepower (PS). OEM registration values retain their accuracy; estimated stage outputs use policy rounding.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.power.oneOf.0","typeLabel":"number"},{"type":"null","description":"Metric horsepower (PS). OEM registration values retain their accuracy; estimated stage outputs use policy rounding.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.power.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.power","typeLabel":"number | null"},"torque":{"oneOf":[{"type":"number","description":"Torque in Nm.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.torque.oneOf.0","typeLabel":"number"},{"type":"null","description":"Torque in Nm.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.torque.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.torque","typeLabel":"number | null"},"top_speed":{"oneOf":[{"type":"number","description":"Maximum speed in km/h when known. Estimates do not predict this value.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.top_speed.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum speed in km/h when known. Estimates do not predict this value.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.top_speed.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.top_speed","typeLabel":"number | null"},"zero_to_hundred":{"oneOf":[{"type":"number","description":"0-100 km/h acceleration in seconds when known. Estimates do not predict this value.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.zero_to_hundred.oneOf.0","typeLabel":"number"},{"type":"null","description":"0-100 km/h acceleration in seconds when known. Estimates do not predict this value.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.zero_to_hundred.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.zero_to_hundred","typeLabel":"number | null"},"dyno_values":{"oneOf":[{"additionalProperties":false,"description":"Dyno object","properties":{"hp":{"description":"HP values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"p93ihoykl0ya1"},"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values.oneOf.0.hp.items.[INDEX]","typeLabel":"integer"},"maxItems":1000,"type":"array","x-stoplight":{"id":"vd6hysqxr0wx8"},"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values.oneOf.0.hp","typeLabel":"integer[]"},"nm":{"description":"Nm values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"6fkv9wbg7h04g"},"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values.oneOf.0.nm.items.[INDEX]","typeLabel":"integer"},"maxItems":1000,"type":"array","x-stoplight":{"id":"4jpbgqaf9x9yh"},"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values.oneOf.0.nm","typeLabel":"integer[]"},"rpm":{"description":"RPM values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"wlvp55ibfn59e"},"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values.oneOf.0.rpm.items.[INDEX]","typeLabel":"integer"},"maxItems":1000,"type":"array","uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values.oneOf.0.rpm","typeLabel":"integer[]"}},"title":"Dyno metadata","type":"object","x-examples":{"Example 1":{"hp":[0,49,87,112,135,140,112,0,0],"nm":[0,238,243,238,233,205,150,0,0],"rpm":[1000,2000,3000,4000,5000,6000,7000,8000,9000]}},"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values.oneOf.0","typeLabel":"Dyno metadata · object"},{"additionalProperties":false,"description":"Dyno object","properties":{"hp":{"description":"HP values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"p93ihoykl0ya1"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"vd6hysqxr0wx8"}},"nm":{"description":"Nm values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"6fkv9wbg7h04g"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"4jpbgqaf9x9yh"}},"rpm":{"description":"RPM values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"wlvp55ibfn59e"}},"maxItems":1000,"type":"array"}},"title":"Dyno metadata","type":"null","x-examples":{"Example 1":{"hp":[0,49,87,112,135,140,112,0,0],"nm":[0,238,243,238,233,205,150,0,0],"rpm":[1000,2000,3000,4000,5000,6000,7000,8000,9000]}},"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_values","typeLabel":"Dyno metadata · object | null"},"power_kw":{"oneOf":[{"type":"number","description":"Power in kW, provided for registration-derived OEM and estimated-stage performance.","uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.power_kw.oneOf.0","typeLabel":"number"},{"type":"null","description":"Power in kW, provided for registration-derived OEM and estimated-stage performance.","uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.power_kw.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.power_kw","typeLabel":"number | null"},"dyno_source":{"oneOf":[{"type":"string","enum":["illustrative",null],"description":"Registration-only curve provenance. Null when no curve can be generated. Matched catalog responses omit this field.","uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_source.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["illustrative",null],"description":"Registration-only curve provenance. Null when no curve can be generated. Matched catalog responses omit this field.","uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_source.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance.dyno_source","typeLabel":"enum\u003cstring> | null"}},"required":["power","torque","top_speed","zero_to_hundred","dyno_values"],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance","typeLabel":"object"},"stage_number":{"description":"Stage display number. Catalog stages have IDs; estimated stages use stage_number and formula_version.","example":1,"type":"integer","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].stage_number","typeLabel":"integer"},"id":{"oneOf":[{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Catalog stage ID, or null for an estimate.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].id.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Catalog stage ID, or null for an estimate.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].id","typeLabel":"integer\u003cint64> | null"},"origin":{"oneOf":[{"type":"string","enum":["shared","private",null],"description":"Catalog stage origin, or null for an estimate.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].origin.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["shared","private",null],"description":"Catalog stage origin, or null for an estimate.","isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].origin.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].origin","typeLabel":"enum\u003cstring> | null"},"source":{"type":"string","enum":["catalog","estimated"],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"formula_version":{"type":"integer","minimum":1,"description":"Included only for estimated stages; identifies the calculation policy.","uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].formula_version","typeLabel":"integer"},"performance_scope":{"type":"string","enum":["combustion"],"description":"Estimated gains apply to the combustion engine only. Electric and combined-system outputs are not estimated.","uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX].performance_scope","typeLabel":"enum\u003cstring>"}},"required":["modifications_required","performance","stage_number","id","origin","source"],"uniqueKey":"engine.oneOf.0.tuning.stages.items.[INDEX]","typeLabel":"object"},"maxItems":1000,"type":"array","x-stoplight":{"id":"i6vvnixufrwnf"},"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.stages","typeLabel":"object[]"},"work_methods":{"description":"List with the methods to use when reading this engine.","items":{"additionalProperties":false,"description":"Work method object","properties":{"name":{"description":"Name.","example":"OBD","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].name","typeLabel":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers.","uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].id","typeLabel":"integer\u003cint64>"},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer.","uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].origin","typeLabel":"enum\u003cstring>"},"code":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].code","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].description","typeLabel":"string | null"},"manufacturer":{"type":"string","uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX].manufacturer","typeLabel":"string"}},"title":"Work method","type":"object","x-examples":{"OBD":{"name":"OBD"}},"uniqueKey":"engine.oneOf.0.tuning.work_methods.items.[INDEX]","typeLabel":"Work method · object"},"maxItems":1000,"type":"array","x-stoplight":{"id":"ppvk2wt69dhp4"},"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning.work_methods","typeLabel":"Work method · object[]"}},"required":["options","read_tools","stages","work_methods"],"isRequired":true,"uniqueKey":"engine.oneOf.0.tuning","typeLabel":"object"},"year":{"oneOf":[{"description":"Year of manufacture.","example":2018,"type":"integer","isRequired":true,"uniqueKey":"engine.oneOf.0.year.oneOf.0","typeLabel":"integer"},{"description":"Year of manufacture.","example":2018,"type":"null","isRequired":true,"uniqueKey":"engine.oneOf.0.year.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.year","typeLabel":"integer | null"},"origin":{"oneOf":[{"type":"string","enum":["shared","private",null],"description":"Catalog origin when matched; null for registration-derived data.","isRequired":true,"uniqueKey":"engine.oneOf.0.origin.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["shared","private",null],"description":"Catalog origin when matched; null for registration-derived data.","isRequired":true,"uniqueKey":"engine.oneOf.0.origin.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.origin","typeLabel":"enum\u003cstring> | null"},"source":{"type":"string","enum":["catalog","registration"],"description":"Whether the engine details come from the account-visible catalog or registration observations. Tuning stages carry their own source.","isRequired":true,"uniqueKey":"engine.oneOf.0.source","typeLabel":"enum\u003cstring>"},"generation_id":{"oneOf":[{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Matched catalog placement; null without a reliable catalog match.","isRequired":true,"uniqueKey":"engine.oneOf.0.generation_id.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Matched catalog placement; null without a reliable catalog match.","isRequired":true,"uniqueKey":"engine.oneOf.0.generation_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.generation_id","typeLabel":"integer\u003cint64> | null"},"oem_power_ps":{"oneOf":[{"type":"number","description":"Compatibility field for OEM metric horsepower (PS). Prefer performance.power for engine-details rendering.","isRequired":true,"uniqueKey":"engine.oneOf.0.oem_power_ps.oneOf.0","typeLabel":"number"},{"type":"null","description":"Compatibility field for OEM metric horsepower (PS). Prefer performance.power for engine-details rendering.","isRequired":true,"uniqueKey":"engine.oneOf.0.oem_power_ps.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.oem_power_ps","typeLabel":"number | null"},"oem_torque_nm":{"oneOf":[{"type":"number","description":"Compatibility field for OEM torque in Nm. Prefer performance.torque for engine-details rendering.","isRequired":true,"uniqueKey":"engine.oneOf.0.oem_torque_nm.oneOf.0","typeLabel":"number"},{"type":"null","description":"Compatibility field for OEM torque in Nm. Prefer performance.torque for engine-details rendering.","isRequired":true,"uniqueKey":"engine.oneOf.0.oem_torque_nm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine.oneOf.0.oem_torque_nm","typeLabel":"number | null"},"powertrain":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.powertrain.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.powertrain.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.powertrain","typeLabel":"string | null"},"combustion_fuel":{"oneOf":[{"type":"string","uniqueKey":"engine.oneOf.0.combustion_fuel.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"engine.oneOf.0.combustion_fuel.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.combustion_fuel","typeLabel":"string | null"},"performance_scope":{"type":"string","enum":["combustion","unspecified"],"description":"Scope of registration-derived power/torque and curves. Matched catalog records retain existing catalog semantics.","uniqueKey":"engine.oneOf.0.performance_scope","typeLabel":"enum\u003cstring>"},"estimation_reason":{"oneOf":[{"type":"string","enum":["combustion_performance_unattributed","combustion_data_conflicting","estimation_unavailable",null],"uniqueKey":"engine.oneOf.0.estimation_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["combustion_performance_unattributed","combustion_data_conflicting","estimation_unavailable",null],"uniqueKey":"engine.oneOf.0.estimation_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"engine.oneOf.0.estimation_reason","typeLabel":"enum\u003cstring> | null"}},"required":["capacity","cylinders","ecus","engine_code","engine_type","fuel","id","name","performance","slug","tcus","tuning","year","origin","source","generation_id","oem_power_ps","oem_torque_nm"],"isRequired":true,"uniqueKey":"engine.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"description":"Engine-details layout, matching GET /engines/{engine_id}, plus lookup provenance. Matched engines include the visible catalog details and account customisations. Unmatched vehicles include known registration specifications and available estimated stages; catalog IDs and unknown facts are null, unsupported equipment is empty; illustrative combustion curves are generated only with reliable component power/torque, known fuel/aspiration and a valid unique template. The whole object is null for a missing vehicle or a catalog visibility restriction. An unavailable estimate may still return known engine details.","properties":{"capacity":{"oneOf":[{"description":"Engine capacity in cubic cm.","example":1800,"type":"integer"},{"description":"Engine capacity in cubic cm.","example":1800,"type":"null"}]},"cylinders":{"oneOf":[{"description":"Number of cylinders.","example":4,"type":"integer"},{"description":"Number of cylinders.","example":4,"type":"null"}]},"ecus":{"description":"List of ECU's used in this engine.","items":{"additionalProperties":false,"description":"ECU object","properties":{"manufacturer":{"description":"Manufacturer.","example":"Bosch","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"ego5g0wgjbx5z"}},"name":{"description":"Name.","example":"EDC17CP54","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers."},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer."},"code":{"oneOf":[{"type":"string"},{"type":"null"}]},"description":{"oneOf":[{"type":"string"},{"type":"null"}]},"model":{"type":"string","description":"Equipment model; retained for existing API clients."}},"title":"ECU","type":"object","x-examples":{"Bosch EDC17":{"manufacturer":"Bosch","name":"EDC17CP54"}}},"maxItems":1000,"type":"array"},"engine_code":{"oneOf":[{"description":"Engine code.","example":"XYZ","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},{"description":"Engine code.","example":"XYZ","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null"}]},"engine_type":{"oneOf":[{"description":"Engine type.","example":"Petrol","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},{"description":"Engine type.","example":"Petrol","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null"}]},"fuel":{"oneOf":[{"description":"Name of the fuel.","example":"Petrol","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},{"description":"Name of the fuel.","example":"Petrol","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null"}]},"id":{"oneOf":[{"description":"Catalog engine ID when matched; null for registration-derived data. provisional_id is a separate review reference and must never be used with /engines/{engine_id}.","example":1234,"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991},{"description":"Catalog engine ID when matched; null for registration-derived data. provisional_id is a separate review reference and must never be used with /engines/{engine_id}.","example":1234,"type":"null","format":"int64","minimum":1,"maximum":9007199254740991}]},"name":{"oneOf":[{"description":"Customised catalog name when matched; otherwise a description assembled from the registration make and derivative/model.","example":"1.8i 125hp 170Nm","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},{"description":"Customised catalog name when matched; otherwise a description assembled from the registration make and derivative/model.","example":"1.8i 125hp 170Nm","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null"}]},"performance":{"type":"object","additionalProperties":false,"description":"OEM engine-details layout. Matched catalog behavior is unchanged. Registration combustion power/torque are component-specific; generic hybrid and electric-motor figures never fill missing combustion maxima. Speed and acceleration, if present, remain vehicle-level observations. Dyno curves are illustrative template output, never measurements; missing or conflicting component inputs or unavailable templates leave arrays empty.","properties":{"power":{"oneOf":[{"type":"number","description":"Metric horsepower (PS). OEM registration values retain their accuracy; estimated stage outputs use policy rounding."},{"type":"null","description":"Metric horsepower (PS). OEM registration values retain their accuracy; estimated stage outputs use policy rounding."}]},"power_kw":{"oneOf":[{"type":"number","description":"Power in kW, provided for registration-derived OEM and estimated-stage performance."},{"type":"null","description":"Power in kW, provided for registration-derived OEM and estimated-stage performance."}]},"power_bhp":{"oneOf":[{"type":"number","description":"Brake horsepower, provided for registration-derived OEM performance when known; distinct from PS."},{"type":"null","description":"Brake horsepower, provided for registration-derived OEM performance when known; distinct from PS."}]},"torque":{"oneOf":[{"type":"number","description":"Torque in Nm."},{"type":"null","description":"Torque in Nm."}]},"top_speed":{"oneOf":[{"type":"number","description":"Maximum speed in km/h when known. Estimates do not predict this value."},{"type":"null","description":"Maximum speed in km/h when known. Estimates do not predict this value."}]},"zero_to_hundred":{"oneOf":[{"type":"number","description":"0-100 km/h acceleration in seconds when known. Estimates do not predict this value."},{"type":"null","description":"0-100 km/h acceleration in seconds when known. Estimates do not predict this value."}]},"dyno_values":{"oneOf":[{"additionalProperties":false,"description":"Dyno object","properties":{"hp":{"description":"HP values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"p93ihoykl0ya1"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"vd6hysqxr0wx8"}},"nm":{"description":"Nm values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"6fkv9wbg7h04g"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"4jpbgqaf9x9yh"}},"rpm":{"description":"RPM values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"wlvp55ibfn59e"}},"maxItems":1000,"type":"array"}},"title":"Dyno metadata","type":"object","x-examples":{"Example 1":{"hp":[0,49,87,112,135,140,112,0,0],"nm":[0,238,243,238,233,205,150,0,0],"rpm":[1000,2000,3000,4000,5000,6000,7000,8000,9000]}}},{"additionalProperties":false,"description":"Dyno object","properties":{"hp":{"description":"HP values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"p93ihoykl0ya1"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"vd6hysqxr0wx8"}},"nm":{"description":"Nm values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"6fkv9wbg7h04g"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"4jpbgqaf9x9yh"}},"rpm":{"description":"RPM values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"wlvp55ibfn59e"}},"maxItems":1000,"type":"array"}},"title":"Dyno metadata","type":"null","x-examples":{"Example 1":{"hp":[0,49,87,112,135,140,112,0,0],"nm":[0,238,243,238,233,205,150,0,0],"rpm":[1000,2000,3000,4000,5000,6000,7000,8000,9000]}}}]},"dyno_source":{"oneOf":[{"type":"string","enum":["illustrative",null],"description":"Registration-only curve provenance. Null when no curve can be generated. Matched catalog responses omit this field."},{"type":"null","enum":["illustrative",null],"description":"Registration-only curve provenance. Null when no curve can be generated. Matched catalog responses omit this field."}]}},"required":["power","torque","dyno_values"]},"slug":{"oneOf":[{"description":"URL-friendly name (slug).","example":"1-8i-125hp-170nm","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},{"description":"URL-friendly name (slug).","example":"1-8i-125hp-170nm","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null"}]},"tcus":{"description":"List of TCU's used in this engine.","items":{"additionalProperties":false,"description":"TCU object","properties":{"manufacturer":{"description":"Manufacturer.","example":"ZF","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},"name":{"description":"Name.","example":"8HP","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers."},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer."},"code":{"oneOf":[{"type":"string"},{"type":"null"}]},"description":{"oneOf":[{"type":"string"},{"type":"null"}]},"model":{"type":"string","description":"Equipment model; retained for existing API clients."}},"title":"TCU","type":"object","x-examples":{"ZF 8HP":{"manufacturer":"ZF","name":"8HP"}}},"maxItems":1000,"type":"array"},"tuning":{"type":"object","additionalProperties":false,"description":"Account-visible tuning data for a matched engine; otherwise empty equipment/options lists and available estimated stages.","properties":{"options":{"description":"Available remap options for this engine.","items":{"additionalProperties":false,"description":"Tuning option object","properties":{"description":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"description":"Name.","example":"EGR","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers."},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer."},"code":{"oneOf":[{"type":"string"},{"type":"null"}]}},"title":"Option","type":"object","x-examples":{"EGR":{"description":"Removal of EGR","name":"EGR"}}},"maxItems":1000,"type":"array"},"read_tools":{"description":"List with the tuning tools which can be used to read this engine.","items":{"additionalProperties":false,"description":"Read Tool object","properties":{"manufacturer":{"description":"Manufacturer.","example":"Alientech","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"ene9p2f5occpc"}},"name":{"description":"Name.","example":"KESS3","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers."},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer."},"code":{"oneOf":[{"type":"string"},{"type":"null"}]},"description":{"oneOf":[{"type":"string"},{"type":"null"}]}},"title":"Read Tool","type":"object","x-examples":{"Alientech KESS3":{"manufacturer":"Alientech","name":"KESS3"}}},"maxItems":1000,"type":"array","x-stoplight":{"id":"lb5q8g6onza8o"}},"stages":{"description":"List with Remap/Tuning Stages.","items":{"type":"object","additionalProperties":false,"description":"Tuning stage in the engine-details layout with explicit provenance. Estimates currently include Stage 1 and Stage 2, rounded to whole PS, kW and Nm. Estimates have null catalog IDs, no inferred modifications, no speed/acceleration predictions and optional illustrative combustion-only curves.","properties":{"modifications_required":{"oneOf":[{"description":"Modifications needed.","example":"Aftermarket intercooler and exhaust required.","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"nxjtpmqu6xw08"}},{"description":"Modifications needed.","example":"Aftermarket intercooler and exhaust required.","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"null","x-stoplight":{"id":"nxjtpmqu6xw08"}}]},"performance":{"type":"object","additionalProperties":false,"description":"Catalog or estimated stage performance. Calculated values are not measured dyno data.","properties":{"power":{"oneOf":[{"type":"number","description":"Metric horsepower (PS). OEM registration values retain their accuracy; estimated stage outputs use policy rounding."},{"type":"null","description":"Metric horsepower (PS). OEM registration values retain their accuracy; estimated stage outputs use policy rounding."}]},"power_kw":{"oneOf":[{"type":"number","description":"Power in kW, provided for registration-derived OEM and estimated-stage performance."},{"type":"null","description":"Power in kW, provided for registration-derived OEM and estimated-stage performance."}]},"torque":{"oneOf":[{"type":"number","description":"Torque in Nm."},{"type":"null","description":"Torque in Nm."}]},"top_speed":{"oneOf":[{"type":"number","description":"Maximum speed in km/h when known. Estimates do not predict this value."},{"type":"null","description":"Maximum speed in km/h when known. Estimates do not predict this value."}]},"zero_to_hundred":{"oneOf":[{"type":"number","description":"0-100 km/h acceleration in seconds when known. Estimates do not predict this value."},{"type":"null","description":"0-100 km/h acceleration in seconds when known. Estimates do not predict this value."}]},"dyno_values":{"oneOf":[{"additionalProperties":false,"description":"Dyno object","properties":{"hp":{"description":"HP values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"p93ihoykl0ya1"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"vd6hysqxr0wx8"}},"nm":{"description":"Nm values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"6fkv9wbg7h04g"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"4jpbgqaf9x9yh"}},"rpm":{"description":"RPM values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"wlvp55ibfn59e"}},"maxItems":1000,"type":"array"}},"title":"Dyno metadata","type":"object","x-examples":{"Example 1":{"hp":[0,49,87,112,135,140,112,0,0],"nm":[0,238,243,238,233,205,150,0,0],"rpm":[1000,2000,3000,4000,5000,6000,7000,8000,9000]}}},{"additionalProperties":false,"description":"Dyno object","properties":{"hp":{"description":"HP values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"p93ihoykl0ya1"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"vd6hysqxr0wx8"}},"nm":{"description":"Nm values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"6fkv9wbg7h04g"}},"maxItems":1000,"type":"array","x-stoplight":{"id":"4jpbgqaf9x9yh"}},"rpm":{"description":"RPM values for plotting a dyno chart.","items":{"type":"integer","x-stoplight":{"id":"wlvp55ibfn59e"}},"maxItems":1000,"type":"array"}},"title":"Dyno metadata","type":"null","x-examples":{"Example 1":{"hp":[0,49,87,112,135,140,112,0,0],"nm":[0,238,243,238,233,205,150,0,0],"rpm":[1000,2000,3000,4000,5000,6000,7000,8000,9000]}}}]},"dyno_source":{"oneOf":[{"type":"string","enum":["illustrative",null],"description":"Registration-only curve provenance. Null when no curve can be generated. Matched catalog responses omit this field."},{"type":"null","enum":["illustrative",null],"description":"Registration-only curve provenance. Null when no curve can be generated. Matched catalog responses omit this field."}]}},"required":["power","torque","top_speed","zero_to_hundred","dyno_values"]},"stage_number":{"description":"Stage display number. Catalog stages have IDs; estimated stages use stage_number and formula_version.","example":1,"type":"integer"},"id":{"oneOf":[{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Catalog stage ID, or null for an estimate."},{"type":"null","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Catalog stage ID, or null for an estimate."}]},"origin":{"oneOf":[{"type":"string","enum":["shared","private",null],"description":"Catalog stage origin, or null for an estimate."},{"type":"null","enum":["shared","private",null],"description":"Catalog stage origin, or null for an estimate."}]},"source":{"type":"string","enum":["catalog","estimated"]},"formula_version":{"type":"integer","minimum":1,"description":"Included only for estimated stages; identifies the calculation policy."},"performance_scope":{"type":"string","enum":["combustion"],"description":"Estimated gains apply to the combustion engine only. Electric and combined-system outputs are not estimated."}},"required":["modifications_required","performance","stage_number","id","origin","source"]},"maxItems":1000,"type":"array","x-stoplight":{"id":"i6vvnixufrwnf"}},"work_methods":{"description":"List with the methods to use when reading this engine.","items":{"additionalProperties":false,"description":"Work method object","properties":{"name":{"description":"Name.","example":"OBD","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string"},"id":{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Stable catalogue ID. Private IDs start at 4294967296; all IDs are exact JavaScript-safe integers."},"origin":{"type":"string","enum":["shared","private"],"description":"Shared catalogue record or an addition owned by the authenticated customer."},"code":{"oneOf":[{"type":"string"},{"type":"null"}]},"description":{"oneOf":[{"type":"string"},{"type":"null"}]},"manufacturer":{"type":"string"}},"title":"Work method","type":"object","x-examples":{"OBD":{"name":"OBD"}}},"maxItems":1000,"type":"array","x-stoplight":{"id":"ppvk2wt69dhp4"}}},"required":["options","read_tools","stages","work_methods"]},"year":{"oneOf":[{"description":"Year of manufacture.","example":2018,"type":"integer"},{"description":"Year of manufacture.","example":2018,"type":"null"}]},"origin":{"oneOf":[{"type":"string","enum":["shared","private",null],"description":"Catalog origin when matched; null for registration-derived data."},{"type":"null","enum":["shared","private",null],"description":"Catalog origin when matched; null for registration-derived data."}]},"source":{"type":"string","enum":["catalog","registration"],"description":"Whether the engine details come from the account-visible catalog or registration observations. Tuning stages carry their own source."},"generation_id":{"oneOf":[{"type":"integer","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Matched catalog placement; null without a reliable catalog match."},{"type":"null","format":"int64","minimum":1,"maximum":9007199254740991,"description":"Matched catalog placement; null without a reliable catalog match."}]},"oem_power_ps":{"oneOf":[{"type":"number","description":"Compatibility field for OEM metric horsepower (PS). Prefer performance.power for engine-details rendering."},{"type":"null","description":"Compatibility field for OEM metric horsepower (PS). Prefer performance.power for engine-details rendering."}]},"oem_torque_nm":{"oneOf":[{"type":"number","description":"Compatibility field for OEM torque in Nm. Prefer performance.torque for engine-details rendering."},{"type":"null","description":"Compatibility field for OEM torque in Nm. Prefer performance.torque for engine-details rendering."}]},"powertrain":{"oneOf":[{"type":"string"},{"type":"null"}]},"combustion_fuel":{"oneOf":[{"type":"string"},{"type":"null"}]},"performance_scope":{"type":"string","enum":["combustion","unspecified"],"description":"Scope of registration-derived power/torque and curves. Matched catalog records retain existing catalog semantics."},"estimation_reason":{"oneOf":[{"type":"string","enum":["combustion_performance_unattributed","combustion_data_conflicting","estimation_unavailable",null]},{"type":"null","enum":["combustion_performance_unattributed","combustion_data_conflicting","estimation_unavailable",null]}]}},"required":["capacity","cylinders","ecus","engine_code","engine_type","fuel","id","name","performance","slug","tcus","tuning","year","origin","source","generation_id","oem_power_ps","oem_torque_nm"],"isRequired":true,"uniqueKey":"engine.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"engine","typeLabel":"object | null"},"match":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"score":{"type":"integer","minimum":0,"maximum":100,"description":"Evidence score, not a probability. Names use normalized exact values or reviewed aliases. Automatic selection also requires the configured evidence checks and an unambiguous engine and generation; a high score alone does not guarantee a match. Missing evidence in alternative candidates cannot justify selecting one candidate over another.","isRequired":true,"uniqueKey":"match.oneOf.0.score","typeLabel":"integer"},"checks":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"points":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"match.oneOf.0.checks.additionalProperties.points","typeLabel":"integer\u003cint64>"},"maximum":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"match.oneOf.0.checks.additionalProperties.maximum","typeLabel":"integer\u003cint64>"},"check":{"type":"string","enum":["missing","match","mismatch"],"isRequired":true,"uniqueKey":"match.oneOf.0.checks.additionalProperties.check","typeLabel":"enum\u003cstring>"}},"required":["points","maximum","check"],"uniqueKey":"match.oneOf.0.checks.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"match.oneOf.0.checks","typeLabel":"object"},"contradictions":{"type":"array","items":{"type":"string","uniqueKey":"match.oneOf.0.contradictions.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"match.oneOf.0.contradictions","typeLabel":"string[]"},"method":{"type":"string","enum":["scored","reviewed_mapping"],"uniqueKey":"match.oneOf.0.method","typeLabel":"enum\u003cstring>"}},"required":["score","checks","contradictions"],"isRequired":true,"uniqueKey":"match.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"properties":{"score":{"type":"integer","minimum":0,"maximum":100,"description":"Evidence score, not a probability. Names use normalized exact values or reviewed aliases. Automatic selection also requires the configured evidence checks and an unambiguous engine and generation; a high score alone does not guarantee a match. Missing evidence in alternative candidates cannot justify selecting one candidate over another."},"checks":{"type":"object","additionalProperties":{"type":"object","additionalProperties":false,"properties":{"points":{"type":"integer","format":"int64","minimum":0},"maximum":{"type":"integer","format":"int64","minimum":0},"check":{"type":"string","enum":["missing","match","mismatch"]}},"required":["points","maximum","check"]}},"contradictions":{"type":"array","items":{"type":"string"}},"method":{"type":"string","enum":["scored","reviewed_mapping"]}},"required":["score","checks","contradictions"],"isRequired":true,"uniqueKey":"match.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"match","typeLabel":"object | null"},"provisional_id":{"oneOf":[{"type":"integer","format":"int64","minimum":0,"maximum":9007199254740991,"description":"A separate staging reference, never a catalog engine ID.","isRequired":true,"uniqueKey":"provisional_id.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","minimum":0,"maximum":9007199254740991,"description":"A separate staging reference, never a catalog engine ID.","isRequired":true,"uniqueKey":"provisional_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"provisional_id","typeLabel":"integer\u003cint64> | null"},"stages":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"stage_number":{"type":"integer","isRequired":true,"uniqueKey":"stages.items.[INDEX].stage_number","typeLabel":"integer"},"source":{"type":"string","enum":["catalog","estimated"],"isRequired":true,"uniqueKey":"stages.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"power_ps":{"type":"number","isRequired":true,"uniqueKey":"stages.items.[INDEX].power_ps","typeLabel":"number"},"power_kw":{"type":"number","isRequired":true,"uniqueKey":"stages.items.[INDEX].power_kw","typeLabel":"number"},"torque_nm":{"type":"number","isRequired":true,"uniqueKey":"stages.items.[INDEX].torque_nm","typeLabel":"number"},"id":{"type":"integer","format":"int64","minimum":0,"maximum":9007199254740991,"uniqueKey":"stages.items.[INDEX].id","typeLabel":"integer\u003cint64>"},"origin":{"type":"string","enum":["shared","private"],"uniqueKey":"stages.items.[INDEX].origin","typeLabel":"enum\u003cstring>"},"formula_version":{"type":"integer","format":"int64","minimum":0,"uniqueKey":"stages.items.[INDEX].formula_version","typeLabel":"integer\u003cint64>"},"performance_scope":{"type":"string","enum":["combustion"],"description":"Estimated gains apply to the combustion engine only. Electric and combined-system outputs are not estimated.","uniqueKey":"stages.items.[INDEX].performance_scope","typeLabel":"enum\u003cstring>"}},"required":["stage_number","source","power_ps","power_kw","torque_nm"],"description":"Catalog stages include id and origin. Estimated stages include formula_version and have no catalog ID. The current default estimation policy returns only Stage 1 and Stage 2, rounding power to whole PS and kW and torque to whole Nm. Stage enablement and rounding are versioned policy settings; OEM vehicle values retain their original precision.","uniqueKey":"stages.items.[INDEX]","typeLabel":"object"},"description":"Compact stages retained for compatibility. New engine-style widgets can use engine.performance and engine.tuning.stages; both stage representations describe the same result.","isRequired":true,"uniqueKey":"stages","typeLabel":"object[]"},"cache":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"hit":{"type":"boolean","isRequired":true,"uniqueKey":"cache.oneOf.0.hit","typeLabel":"boolean"},"observed_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"cache.oneOf.0.observed_at","typeLabel":"string\u003cdate-time>"}},"required":["hit","observed_at"],"isRequired":true,"uniqueKey":"cache.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"properties":{"hit":{"type":"boolean"},"observed_at":{"type":"string","format":"date-time"}},"required":["hit","observed_at"],"isRequired":true,"uniqueKey":"cache.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"cache","typeLabel":"object | null"},"consumption":{"type":"string","enum":["none","included","credits"],"description":"Consumption by this request execution. Cached and idempotent replays consume none.","isRequired":true,"uniqueKey":"consumption","typeLabel":"enum\u003cstring>"},"usage":{"oneOf":[{"type":"object","description":"Current usage when normal VRM access is authorized; null for test-only access. Test-only access does not create an allowance period.","required":["included_limit","included_used","included_reserved","included_remaining","credit_balance","credit_reserved","credits_available","resets_at"],"example":{"included_limit":600,"included_used":6,"included_reserved":0,"included_remaining":594,"credit_balance":100,"credit_reserved":0,"credits_available":100,"resets_at":"2026-11-08T11:53:00Z"},"properties":{"included_limit":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"usage.oneOf.0.included_limit","typeLabel":"integer\u003cint64>"},"included_used":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"usage.oneOf.0.included_used","typeLabel":"integer\u003cint64>"},"included_reserved":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"usage.oneOf.0.included_reserved","typeLabel":"integer\u003cint64>"},"included_remaining":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"usage.oneOf.0.included_remaining","typeLabel":"integer\u003cint64>"},"credit_balance":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"usage.oneOf.0.credit_balance","typeLabel":"integer\u003cint64>"},"credit_reserved":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"usage.oneOf.0.credit_reserved","typeLabel":"integer\u003cint64>"},"credits_available":{"type":"integer","format":"int64","minimum":0,"isRequired":true,"uniqueKey":"usage.oneOf.0.credits_available","typeLabel":"integer\u003cint64>"},"resets_at":{"type":"string","format":"date-time","description":"Next monthly anniversary in UTC, including for annual subscriptions.","isRequired":true,"uniqueKey":"usage.oneOf.0.resets_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"usage.oneOf.0","typeLabel":"object"},{"type":"object","description":"Current usage when normal VRM access is authorized; null for test-only access. Test-only access does not create an allowance period.","enum":[null],"isRequired":true,"uniqueKey":"usage.oneOf.1","typeLabel":"object"},{"type":"null","description":"Current usage when normal VRM access is authorized; null for test-only access. Test-only access does not create an allowance period.","enum":[null],"isRequired":true,"uniqueKey":"usage.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage","typeLabel":"object · object · null"},"is_test":{"type":"boolean","description":"True for a staff-designated saved test registration. These lookups never consume included or purchased credits.","isRequired":true,"uniqueKey":"is_test","typeLabel":"boolean"},"reason":{"oneOf":[{"type":"string","description":"Resolution or estimation reason. combustion_performance_unattributed means hybrid combustion power/torque are not separately identified; combustion_data_conflicting means component measurements or fuel disagree. Such results withhold tuning stages and curves.","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Resolution or estimation reason. combustion_performance_unattributed means hybrid combustion power/torque are not separately identified; combustion_data_conflicting means component measurements or fuel disagree. Such results withhold tuning stages and curves.","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"}},"required":["lookup_id","status","vehicle","engine","match","provisional_id","stages","cache","consumption","usage","is_test"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"lookup_id":4503599627370495,"status":"matched","vehicle":{"make":"\u003cstring>","model":"\u003cstring>","derivative":"\u003cstring>","series":"\u003cstring>","fuel":"\u003cstring>","powertrain":"\u003cstring>","aspiration":"\u003cstring>","engine_code":"\u003cstring>","engine_code_source":"\u003cstring>","derivative_id":"\u003cstring>","vrm":"\u003cstring>","vehicle_type":123,"year":123,"capacity_cc":123,"power_kw":123,"power_ps":123,"power_bhp":123,"torque_nm":123,"reported_power":{"kw":123,"ps":123,"bhp":123},"details":{"identification":{"vrm":"SA22NNB","date_first_registered":"2022-03-01T00:00:00","year_of_manufacture":2022},"history":{"colour_details":{"current_colour":"BLUE","number_of_colour_changes":0}},"status":{"is_imported":false,"is_scrapped":false},"powertrain":{"transmission":{"transmission_type":"Automatic","number_of_gears":8}},"performance":{"power":{"kw":131,"ps":178.2,"bhp":175.7},"torque":{"nm":280}}},"combustion_fuel":"petrol","powertrain_type":"\u003cstring>","performance_version":123,"performance_components":{"combustion":{"power_kw":123,"power_ps":123,"power_bhp":123,"torque_nm":123,"issues":["conflicting_power"],"fuel":"petrol","aspiration":"turbo"},"electric_motors":[{"power_kw":123,"power_ps":123,"power_bhp":123,"torque_nm":123,"issues":["conflicting_power"]}],"combined":{"power_kw":123,"power_ps":123,"power_bhp":123,"torque_nm":123,"issues":["conflicting_power"]},"unattributed":{"power_kw":123,"power_ps":123,"power_bhp":123,"torque_nm":123,"issues":["conflicting_power"]}}},"engine":{"capacity":1800,"cylinders":4,"ecus":[{"manufacturer":"Bosch","name":"EDC17CP54","id":4503599627370496,"origin":"shared","code":"\u003cstring>","description":"\u003cstring>","model":"\u003cstring>"}],"engine_code":"XYZ","engine_type":"Petrol","fuel":"Petrol","id":1234,"name":"1.8i 125hp 170Nm","performance":{"power":123,"torque":123,"dyno_values":{"hp":[123],"nm":[123],"rpm":[123]},"power_kw":123,"power_bhp":123,"top_speed":123,"zero_to_hundred":123,"dyno_source":"illustrative"},"slug":"1-8i-125hp-170nm","tcus":[{"manufacturer":"ZF","name":"8HP","id":4503599627370496,"origin":"shared","code":"\u003cstring>","description":"\u003cstring>","model":"\u003cstring>"}],"tuning":{"options":[{"description":"\u003cstring>","name":"EGR","id":4503599627370496,"origin":"shared","code":"\u003cstring>"}],"read_tools":[{"manufacturer":"Alientech","name":"KESS3","id":4503599627370496,"origin":"shared","code":"\u003cstring>","description":"\u003cstring>"}],"stages":[{"modifications_required":"Aftermarket intercooler and exhaust required.","performance":{"power":123,"torque":123,"top_speed":123,"zero_to_hundred":123,"dyno_values":{"hp":[123],"nm":[123],"rpm":[123]},"power_kw":123,"dyno_source":"illustrative"},"stage_number":1,"id":4503599627370496,"origin":"shared","source":"catalog","formula_version":2,"performance_scope":"combustion"}],"work_methods":[{"name":"OBD","id":4503599627370496,"origin":"shared","code":"\u003cstring>","description":"\u003cstring>","manufacturer":"\u003cstring>"}]},"year":2018,"origin":"shared","source":"catalog","generation_id":4503599627370496,"oem_power_ps":123,"oem_torque_nm":123,"powertrain":"\u003cstring>","combustion_fuel":"\u003cstring>","performance_scope":"combustion","estimation_reason":"combustion_performance_unattributed"},"match":{"score":50,"checks":{},"contradictions":["\u003cstring>"],"method":"scored"},"provisional_id":4503599627370495,"stages":[{"stage_number":123,"source":"catalog","power_ps":123,"power_kw":123,"torque_nm":123,"id":4503599627370495,"origin":"shared","formula_version":1,"performance_scope":"combustion"}],"cache":{"hit":true,"observed_at":"2023-11-07T05:31:56Z"},"consumption":"none","usage":{"included_limit":600,"included_used":6,"included_reserved":0,"included_remaining":594,"credit_balance":100,"credit_reserved":0,"credits_available":100,"resets_at":"2026-11-08T11:53:00Z"},"is_test":true,"reason":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c858cf39-ef13-490a-a03f-d203c10ab693":{"description":"Invalid registration, body or Idempotency-Key.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"additionalProperties":false,"description":"Error object","properties":{"code":{"description":"Error code. Typically it will be the same as the returtned HTTP response code.","example":404,"type":"integer","uniqueKey":"error.code","typeLabel":"integer"},"message":{"description":"Error message.","example":"Not found","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"iaxsxsm0kqi9n"},"uniqueKey":"error.message","typeLabel":"string"}},"title":"Error","type":"object","x-examples":{"Bad Request":{"code":400,"message":"Bad request / Malformed parameter"},"Internal Server Error":{"code":500,"message":"Internal Server Error"},"Invalid API key":{"code":403,"message":"Invalid API key"},"Method Not Found":{"code":404,"message":"Method not found"},"No API Access":{"code":401,"message":"API access is not enabled for this subscription"},"No active subscription":{"code":401,"message":"This method requires an active subscription."},"No permissions":{"code":401,"message":"This API key does not have enough permissions"}},"isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Not found"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2de5542f-517f-4611-901d-72b15b5f03d6":{"description":"Missing vdb_read scope, API access entitlement, or active subscription.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"additionalProperties":false,"description":"Error object","properties":{"code":{"description":"Error code. Typically it will be the same as the returtned HTTP response code.","example":404,"type":"integer","uniqueKey":"error.code","typeLabel":"integer"},"message":{"description":"Error message.","example":"Not found","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"iaxsxsm0kqi9n"},"uniqueKey":"error.message","typeLabel":"string"}},"title":"Error","type":"object","x-examples":{"Bad Request":{"code":400,"message":"Bad request / Malformed parameter"},"Internal Server Error":{"code":500,"message":"Internal Server Error"},"Invalid API key":{"code":403,"message":"Invalid API key"},"Method Not Found":{"code":404,"message":"Method not found"},"No API Access":{"code":401,"message":"API access is not enabled for this subscription"},"No active subscription":{"code":401,"message":"This method requires an active subscription."},"No permissions":{"code":401,"message":"This API key does not have enough permissions"}},"isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Not found"}}}},"exampleType":"generated"}},"exampleType":"generated"},"655d9942-b6de-40ad-bdf5-e7817484b5ae":{"description":"Missing or invalid API key, or VRM access denied (including Free accounts).","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"additionalProperties":false,"description":"Error object","properties":{"code":{"description":"Error code. Typically it will be the same as the returtned HTTP response code.","example":404,"type":"integer","uniqueKey":"error.code","typeLabel":"integer"},"message":{"description":"Error message.","example":"Not found","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"iaxsxsm0kqi9n"},"uniqueKey":"error.message","typeLabel":"string"}},"title":"Error","type":"object","x-examples":{"Bad Request":{"code":400,"message":"Bad request / Malformed parameter"},"Internal Server Error":{"code":500,"message":"Internal Server Error"},"Invalid API key":{"code":403,"message":"Invalid API key"},"Method Not Found":{"code":404,"message":"Method not found"},"No API Access":{"code":401,"message":"API access is not enabled for this subscription"},"No active subscription":{"code":401,"message":"This method requires an active subscription."},"No permissions":{"code":401,"message":"This API key does not have enough permissions"}},"isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Not found"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d35b5075-fce3-4053-bef0-3380c4348fcb":{"description":"Idempotency-Key reused for a different plate, or its observation has been invalidated.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"additionalProperties":false,"description":"Error object","properties":{"code":{"description":"Error code. Typically it will be the same as the returtned HTTP response code.","example":404,"type":"integer","uniqueKey":"error.code","typeLabel":"integer"},"message":{"description":"Error message.","example":"Not found","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"iaxsxsm0kqi9n"},"uniqueKey":"error.message","typeLabel":"string"}},"title":"Error","type":"object","x-examples":{"Bad Request":{"code":400,"message":"Bad request / Malformed parameter"},"Internal Server Error":{"code":500,"message":"Internal Server Error"},"Invalid API key":{"code":403,"message":"Invalid API key"},"Method Not Found":{"code":404,"message":"Method not found"},"No API Access":{"code":401,"message":"API access is not enabled for this subscription"},"No active subscription":{"code":401,"message":"This method requires an active subscription."},"No permissions":{"code":401,"message":"This API key does not have enough permissions"}},"isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Not found"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6a014d9a-188a-478d-a155-20cfd4455fda":{"description":"Lookup requires Content-Type: application/json.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"additionalProperties":false,"description":"Error object","properties":{"code":{"description":"Error code. Typically it will be the same as the returtned HTTP response code.","example":404,"type":"integer","uniqueKey":"error.code","typeLabel":"integer"},"message":{"description":"Error message.","example":"Not found","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"iaxsxsm0kqi9n"},"uniqueKey":"error.message","typeLabel":"string"}},"title":"Error","type":"object","x-examples":{"Bad Request":{"code":400,"message":"Bad request / Malformed parameter"},"Internal Server Error":{"code":500,"message":"Internal Server Error"},"Invalid API key":{"code":403,"message":"Invalid API key"},"Method Not Found":{"code":404,"message":"Method not found"},"No API Access":{"code":401,"message":"API access is not enabled for this subscription"},"No active subscription":{"code":401,"message":"This method requires an active subscription."},"No permissions":{"code":401,"message":"This API key does not have enough permissions"}},"isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Not found"}}}},"exampleType":"generated"}},"exampleType":"generated"},"63862763-f8f4-439f-b2df-aebd5dc0a23e":{"description":"Rate limit or included allowance and credit balance exhausted. Cache hits remain available to entitled API or MAX accounts.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"additionalProperties":false,"description":"Error object","properties":{"code":{"description":"Error code. Typically it will be the same as the returtned HTTP response code.","example":404,"type":"integer","uniqueKey":"error.code","typeLabel":"integer"},"message":{"description":"Error message.","example":"Not found","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"iaxsxsm0kqi9n"},"uniqueKey":"error.message","typeLabel":"string"}},"title":"Error","type":"object","x-examples":{"Bad Request":{"code":400,"message":"Bad request / Malformed parameter"},"Internal Server Error":{"code":500,"message":"Internal Server Error"},"Invalid API key":{"code":403,"message":"Invalid API key"},"Method Not Found":{"code":404,"message":"Method not found"},"No API Access":{"code":401,"message":"API access is not enabled for this subscription"},"No active subscription":{"code":401,"message":"This method requires an active subscription."},"No permissions":{"code":401,"message":"This API key does not have enough permissions"}},"isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Not found"}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"description":"Seconds until a retry may be attempted when supplied. Reuse the same Idempotency-Key to avoid repeating a provider call.","schema":{"type":"integer"}}},"exampleType":"generated"},"5cabc5ac-d086-4ccf-b6ba-2a9de7b568bf":{"description":"Service unavailable, provider unavailable, or test_registration_unavailable (missing or invalidated test data; no provider fallback).","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"additionalProperties":false,"description":"Error object","properties":{"code":{"description":"Error code. Typically it will be the same as the returtned HTTP response code.","example":404,"type":"integer","uniqueKey":"error.code","typeLabel":"integer"},"message":{"description":"Error message.","example":"Not found","maxLength":2048,"pattern":"^[^\\u0000-\\u001F\\u007F]*$","type":"string","x-stoplight":{"id":"iaxsxsm0kqi9n"},"uniqueKey":"error.message","typeLabel":"string"}},"title":"Error","type":"object","x-examples":{"Bad Request":{"code":400,"message":"Bad request / Malformed parameter"},"Internal Server Error":{"code":500,"message":"Internal Server Error"},"Invalid API key":{"code":403,"message":"Invalid API key"},"Method Not Found":{"code":404,"message":"Method not found"},"No API Access":{"code":401,"message":"API access is not enabled for this subscription"},"No active subscription":{"code":401,"message":"This method requires an active subscription."},"No permissions":{"code":401,"message":"This API key does not have enough permissions"}},"isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Not found"}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"description":"Seconds until a retry may be attempted when supplied. Reuse the same Idempotency-Key to avoid repeating a provider call.","schema":{"type":"integer"}}},"exampleType":"generated"}},"security":{"4280f774-fc9a-4ee2-b413-2a977b8d8a2e":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"All API methods require Bearer authentication.\nUse your existing API key as the bearer token.\n\nAuthorization header format: `Authorization: Bearer YOUR_API_KEY`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"1b9735ae-e90d-461d-9f84-c56b8a46a2ef":{"url":"https://api.remapdb.com/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"All API methods require Bearer authentication.\nUse your existing API key as the bearer token.\n\nAuthorization header format: `Authorization: Bearer YOUR_API_KEY`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"All API methods require Bearer authentication.\nUse your existing API key as the bearer token.\n\nAuthorization header format: `Authorization: Bearer YOUR_API_KEY`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi-v2.json"},"subdomain":"remapdb","siteName":"Remapdb Docs","title":"Look up a UK registration - Remapdb Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T10:41:38.094Z","originalFileLocation":"api-reference/v2/vrm-lookup/look-up-a-uk-registration.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"UK registrations only. The uk path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup. Requires a valid API key with vdb_read. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as Authorization: Bearer . Successful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts. Every retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return 503 test_registration_unavailable; they never trigger a provider call. An Idempotency-Key is scoped to the account and normalized plate; reusing it for a different plate returns 409. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key. The engine object follows the engine-details layout: use engine.performance for OEM data and engine.tuning.stages for tuned data. A matched engine includes the full account-visible catalog details and customisations. Without a reliable match, known registration specifications fill the same fields, engine.id is null, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog. Broad registration attributes remain under vehicle.details. Power is metric horsepower (PS), torque is Nm.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Remapdb Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Look up a UK registration - Remapdb Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"UK registrations only. The uk path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup. Requires a valid API key with vdb_read. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as Authorization: Bearer . Successful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts. Every retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return 503 test_registration_unavailable; they never trigger a provider call. An Idempotency-Key is scoped to the account and normalized plate; reusing it for a different plate returns 409. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key. The engine object follows the engine-details layout: use engine.performance for OEM data and engine.tuning.stages for tuned data. A matched engine includes the full account-visible catalog details and customisations. Without a reliable match, known registration specifications fill the same fields, engine.id is null, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog. Broad registration attributes remain under vehicle.details. Power is metric horsepower (PS), torque is Nm.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Remapdb Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://remapdb.mintlify.site/_mintlify/api/og/v2?division=VRM+lookup\u0026amp;title=Look+up+a+UK+registration\u0026amp;description=UK+registrations+only.+The+%60uk%60+path+segment+selects+the+country-specific+lookup%3B+unsupported+countries+are+not+routed+to+UK+lookup.%0A%0ARequires+a+valid+API+key+w\u0026amp;theme=e5adf7a7050609580bf0be12\u0026amp;signature=d394d32305fe9b4e9b5ba5cfb970da627686318575b01ce8d2250e30c6184571\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Look up a UK registration - Remapdb Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"UK registrations only. The uk path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup. Requires a valid API key with vdb_read. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as Authorization: Bearer . Successful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts. Every retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return 503 test_registration_unavailable; they never trigger a provider call. An Idempotency-Key is scoped to the account and normalized plate; reusing it for a different plate returns 409. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key. The engine object follows the engine-details layout: use engine.performance for OEM data and engine.tuning.stages for tuned data. A matched engine includes the full account-visible catalog details and customisations. Without a reliable match, known registration specifications fill the same fields, engine.id is null, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog. Broad registration attributes remain under vehicle.details. Power is metric horsepower (PS), torque is Nm.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://remapdb.mintlify.site/_mintlify/api/og/v2?division=VRM+lookup\u0026amp;title=Look+up+a+UK+registration\u0026amp;description=UK+registrations+only.+The+%60uk%60+path+segment+selects+the+country-specific+lookup%3B+unsupported+countries+are+not+routed+to+UK+lookup.%0A%0ARequires+a+valid+API+key+w\u0026amp;theme=e5adf7a7050609580bf0be12\u0026amp;signature=d394d32305fe9b4e9b5ba5cfb970da627686318575b01ce8d2250e30c6184571\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Remapdb Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#31374A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2/vrm-lookup/look-up-a-uk-registration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.remapdb.com/#organization\",\"name\":\"Remapdb Docs\",\"url\":\"https://docs.remapdb.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/remapdb/kv3qo15nTX1Sjbyu/assets/branding/remapdb-logo-small-full-light.svg?fit=max\u0026auto=format\u0026n=kv3qo15nTX1Sjbyu\u0026q=85\u0026s=43a8b24bbe8a0dbd37bf83eb53389324\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.remapdb.com#website\",\"name\":\"Remapdb Docs\",\"url\":\"https://docs.remapdb.com\",\"publisher\":{\"@id\":\"https://docs.remapdb.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration#webpage\",\"url\":\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration\",\"name\":\"Look up a UK registration\",\"description\":\"UK registrations only. The uk path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup. Requires a valid API key with vdb_read. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as Authorization: Bearer . Successful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts. Every retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return 503 test_registration_unavailable; they never trigger a provider call. An Idempotency-Key is scoped to the account and normalized plate; reusing it for a different plate returns 409. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key. The engine object follows the engine-details layout: use engine.performance for OEM data and engine.tuning.stages for tuned data. A matched engine includes the full account-visible catalog details and customisations. Without a reliable match, known registration specifications fill the same fields, engine.id is null, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog. Broad registration attributes remain under vehicle.details. Power is metric horsepower (PS), torque is Nm.\",\"dateModified\":\"2026-11-16T10:41:38.094Z\",\"isPartOf\":{\"@id\":\"https://docs.remapdb.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API v2\",\"item\":\"https://docs.remapdb.com/api-reference/v2/subscription/active-subscription\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Look up a UK registration\",\"item\":\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration#apireference\",\"headline\":\"Look up a UK registration\",\"name\":\"Look up a UK registration\",\"description\":\"UK registrations only. The uk path segment selects the country-specific lookup; unsupported countries are not routed to UK lookup. Requires a valid API key with vdb_read. Staff-designated test registrations are available on every plan, including API trials, exclusively from saved data and without consuming lookup credits. All other registrations require an active API or MAX full API subscription and UK VRM entitlement. Supply the API key as Authorization: Bearer . Successful external lookups consume one included unit, then one nonexpiring credit. Cached results consume nothing. Identical concurrent misses are coalesced across accounts. Every retry rechecks account access, test designation and catalog visibility. Test records with missing or invalidated saved data return 503 test_registration_unavailable; they never trigger a provider call. An Idempotency-Key is scoped to the account and normalized plate; reusing it for a different plate returns 409. Failed or not-found requests stay final for that key: a deliberately new attempt after cooldown needs a new key. The engine object follows the engine-details layout: use engine.performance for OEM data and engine.tuning.stages for tuned data. A matched engine includes the full account-visible catalog details and customisations. Without a reliable match, known registration specifications fill the same fields, engine.id is null, and tuning stages are explicitly estimated. Unknown facts remain null or empty; reliable combustion performance can include illustrative template-generated dyno curves. Ambiguous hybrid component data is withheld. Estimated stages are explicitly labeled and never published into the catalog. Broad registration attributes remain under vehicle.details. Power is metric horsepower (PS), torque is Nm.\",\"url\":\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration\",\"mainEntityOfPage\":{\"@id\":\"https://docs.remapdb.com/api-reference/v2/vrm-lookup/look-up-a-uk-registration#webpage\"},\"dateModified\":\"2026-11-16T10:41:38.094Z\",\"publisher\":{\"@id\":\"https://docs.remapdb.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.remapdb.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Remapdb Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Remapdb Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v2/vrm-lookup/look-up-a-uk-registration.md","siteName":"Remapdb Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Migration","pages":[{"title":"Migrate from API v1 to v2","href":"/api/migrate-to-v2"}]},{"group":"API v2","pages":[{"group":"API Subscription","pages":[{"title":"Active Subscription","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /subscription","href":"/api-reference/v2/subscription/active-subscription"}]},{"group":"Vehicle Types","pages":[{"title":"Vehicle Types","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /types","href":"/api-reference/v2/types/vehicle-types"}]},{"group":"Manufacturers","pages":[{"title":"Manufacturers by Type","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /manufacturers/type/{type_id}","href":"/api-reference/v2/manufacturers/manufacturers-by-type"},{"title":"Manufacturer Details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /manufacturers/{manufacturer_id}","href":"/api-reference/v2/manufacturers/manufacturer-details"}]},{"group":"Models","pages":[{"title":"Models by Manufacturer","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /models/manufacturer/{manufacturer_id}","href":"/api-reference/v2/models/models-by-manufacturer"},{"title":"Model Details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /models/{model_id}","href":"/api-reference/v2/models/model-details"}]},{"group":"Generations","pages":[{"title":"Generations by Model","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /generations/model/{model_id}","href":"/api-reference/v2/generations/generations-by-model"},{"title":"Generation Details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /generations/{generation_id}","href":"/api-reference/v2/generations/generation-details"}]},{"group":"Engines","pages":[{"title":"Engines by Generation","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /engines/generation/{generation_id}","href":"/api-reference/v2/engines/engines-by-generation"},{"title":"Engine Details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /engines/{engine_id}","href":"/api-reference/v2/engines/engine-details"}]},{"group":"Search","pages":[{"title":"Vehicle Search","description":"Searches through manufacturers, models, generations and engines.","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /search","href":"/api-reference/v2/search/vehicle-search"}]},{"group":"VRM lookup","pages":[{"title":"Look up a UK registration","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /vrm/uk/lookup","href":"/api-reference/v2/vrm-lookup/look-up-a-uk-registration"},{"title":"Get account UK VRM allowance and credits","description":"One shared account balance covers every widget, REST API key and MCP client. Included allowance resets at the monthly UTC subscription anniversary; purchased credits never expire. Requires vdb_read, an active API or MAX full API subscription and UK VRM entitlement. Trial API access never grants access to this endpoint. Published allowance revisions apply immediately at their effective date, including during an existing period. The current plan determines the included limit; used and reserved lookups and purchased credits are preserved. A limit below existing consumption leaves zero included lookups remaining. Purchased units remain after cancellation and can be used through widgets on Free, with no included allowance. REST and MCP still require active API or MAX full API access. Retail purchase prices are published independently of provider contract costs.","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /vrm/uk/usage","href":"/api-reference/v2/vrm-lookup/get-account-uk-vrm-allowance-and-credits"}]},{"group":"ECU observation","pages":[{"title":"ECU capabilities","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/capabilities","href":"/api-reference/v2/ecu-observation/ecu-capabilities"},{"title":"Upload an ECU binary","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/files","href":"/api-reference/v2/ecu-observation/upload-an-ecu-binary"},{"title":"Delete an ECU upload","deprecated":null,"version":null,"openapi":"/openapi-v2.json delete /ecu/files/{file_id}","href":"/api-reference/v2/ecu-observation/delete-an-ecu-upload"},{"title":"Analyze an ECU binary","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/analyses","href":"/api-reference/v2/ecu-observation/analyze-an-ecu-binary"},{"title":"Compare two ECU binaries","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/comparisons","href":"/api-reference/v2/ecu-observation/compare-two-ecu-binaries"},{"title":"Find candidate ECU maps","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/map-scans","href":"/api-reference/v2/ecu-observation/find-candidate-ecu-maps"},{"title":"Read a map’s cell values","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/map-grids","href":"/api-reference/v2/ecu-observation/read-a-map’s-cell-values"},{"title":"Get ECU job status","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/jobs/{job_id}","href":"/api-reference/v2/ecu-observation/get-ecu-job-status"},{"title":"Get a compact ECU report","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/jobs/{job_id}/result","href":"/api-reference/v2/ecu-observation/get-a-compact-ecu-report"},{"title":"Get ECU observation details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/jobs/{job_id}/details","href":"/api-reference/v2/ecu-observation/get-ecu-observation-details"},{"title":"Identify an ECU from a binary file","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/identifications","href":"/api-reference/v2/ecu-observation/identify-an-ecu-from-a-binary-file"},{"title":"Download all ECU map candidates","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/jobs/{job_id}/artifacts/maps","href":"/api-reference/v2/ecu-observation/download-all-ecu-map-candidates"}]},{"group":"DTC lookup","pages":[{"title":"Look up a DTC code","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /dtc/codes/{code}","href":"/api-reference/v2/dtc-lookup/look-up-a-dtc-code"},{"title":"Search DTC codes","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /dtc/codes","href":"/api-reference/v2/dtc-lookup/search-dtc-codes"},{"title":"Look up multiple DTC codes","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /dtc/lookup","href":"/api-reference/v2/dtc-lookup/look-up-multiple-dtc-codes"},{"title":"List DTC manufacturers","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /dtc/manufacturers","href":"/api-reference/v2/dtc-lookup/list-dtc-manufacturers"}]}]},{"group":"API v1 (deprecated)","pages":[{"group":"API Subscription","pages":[{"title":"Active Subscription","deprecated":true,"version":null,"openapi":"/openapi.json get /subscription","href":"/api-reference/subscription/active-subscription"}]},{"group":"Vehicle Types","pages":[{"title":"Vehicle Types","deprecated":true,"version":null,"openapi":"/openapi.json get /types","href":"/api-reference/types/vehicle-types"}]},{"group":"Manufacturers","pages":[{"title":"Manufacturers by Type","deprecated":true,"version":null,"openapi":"/openapi.json get /manufacturers/type/{type_id}","href":"/api-reference/manufacturers/manufacturers-by-type"},{"title":"Manufacturer Details","deprecated":true,"version":null,"openapi":"/openapi.json get /manufacturers/{manufacturer_id}","href":"/api-reference/manufacturers/manufacturer-details"}]},{"group":"Models","pages":[{"title":"Models by Manufacturer","deprecated":true,"version":null,"openapi":"/openapi.json get /models/manufacturer/{manufacturer_id}","href":"/api-reference/models/models-by-manufacturer"},{"title":"Model Details","deprecated":true,"version":null,"openapi":"/openapi.json get /models/{model_id}","href":"/api-reference/models/model-details"}]},{"group":"Generations","pages":[{"title":"Generations by Model","deprecated":true,"version":null,"openapi":"/openapi.json get /generations/model/{model_id}","href":"/api-reference/generations/generations-by-model"},{"title":"Generation Details","deprecated":true,"version":null,"openapi":"/openapi.json get /generations/{generation_id}","href":"/api-reference/generations/generation-details"}]},{"group":"Engines","pages":[{"title":"Engines by Generation","deprecated":true,"version":null,"openapi":"/openapi.json get /engines/generation/{generation_id}","href":"/api-reference/engines/engines-by-generation"},{"title":"Engine Details","deprecated":true,"version":null,"openapi":"/openapi.json get /engines/{engine_id}","href":"/api-reference/engines/engine-details"}]},{"group":"Search","pages":[{"title":"Vehicle Search","deprecated":true,"version":null,"openapi":"/openapi.json get /search","href":"/api-reference/search/vehicle-search"}]}]}]}]},"basePath":"","title":"Look up a UK registration - Remapdb Docs","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-BFmjTMeT.js","utils-BWr-sjpP.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-LafIDf0N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-MJNzuxek.js","snippetPresets-DPZEtUvW.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-CWFqNdGh.js","ApiExamples-DQ2UhGIs.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DUUJTUkE.js","shallow-BTf5bw35.js","getApiPlaygroundDisplay-h2POYYOO.js","CodeSnippet-C4qEftRe.js","CodeSnippets-CsSrOqMC.js","getPastedJson-DU6W6y78.js","icon-2ZYNQ78y.js","MethodPill-BMXJzYMm.js","DuplicateIcon-DNjdEpYZ.js","createIcon-WdPVhKxl.js","DynamicMarkdown-Z_y464fM.js","SectionHeading-Bcrd8azU.js","axios-vUo_bRtp.js","Markdown-BnvucbFu.js","dist-D7YyC486.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-D1I8TPjt.js"]}