Skip to main content
POST
Look up a UK registration

Authorizations

Authorization
string
header
required

All API methods require Bearer authentication. Use your existing API key as the bearer token.

Authorization header format: Authorization: Bearer YOUR_API_KEY.

Headers

Idempotency-Key
string
required

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.

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.

match
object | null
required
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.

cache
object | null
required
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.

Example:
is_test
boolean
required

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.