Vehicle lookups

  1. Retrieve Vehicles by UK VRM

Vehicles by UK VRM

This method returns an object containing vehicles available for specified UK VRM

Request format

URI vehicle-identifiers/v1/uk-plates/:vrm-id
Sample URL vehicle-identifiers/v1/uk-plates/RO56DDJ?country-code=gb
Request type GET

 

ParameterLocationDescriptionTypeExampleRequired
:vrm-id uri Vehicle Registration Marks number string RO56DDJ Yes
Accept-Language Header culture information for the language/country based on ISO standard string en-gb;q=0.8,en;q=0.7,fr-fr;q=0.4 Yes

country-code query ISO Country culture information for the language/country based on ISO standard string gb Yes

 

Response format

Output: A JSON object of the following structure:

{
    "data": {
        "plate": "RO56DDJ",
        "vehicles": [{
            "manufacturer": "Volkswagen",
            "manufacturer_id": "VOL0",
            "model_id": "115000008",
            "model": "Beetle",
            "subbody": "(1C1\/9C1\/1Y7) (98-11)",
            "litres": 1.6,
            "fuel": "P",
            "extra_info": "",
            "engine_code": "BFS",
            "kw": 74,
            "tuning": "R-Cat",
            "rpm": 5600,
            "din_hp": 100,
            "start_year": "2002",
            "end_year": "2011",
            "mid": "VOL14430",
            "veh_type": "1",
            "type_abbr": "PC",
            "registration_date": "2006-09-13",
            "sort_order": 1,
            "href": "\/v1\/vehicles\/VOL14430?country-code=gb",
            "warnings": "\/v1\/vehicles\/VOL14430\/warnings?country-code=gb"
        }]
    },
    "metadata": {
        "total": 1,
        "page": 1,
        "pages": 1,
        "limit": 20,
        "links": {
            "self": {
                "href": "\/vehicle-identifiers\/v1\/uk-plates\/RO56DDJ?country-code=gb&limit=20&page=1"
            }
        }
    }
}

Object Structure

Vehicle lookup Object

Returned codes

 

HTTPS statusDescription
200 Success
400 Bad Request 

404 Page Not Found
500 Internal Server Error