VIN & Registration Search Features

Enhance your requests with additional data.

You can request more data than the standard payload by leveraging a range of features described below.

Ensure your commercial agreement has these features enabled if you require them.

Extended Data

This feature will return an extended payload of vehicle data from the registration authority. Use features=extended_data to receive this payload.

   "extended_data": {
        "body_type_description": "CAR/SEDAN",
        "color_description": "WHITE",
        "engine_number": "DKJ039523",
        "make_code": "VOLKS",
        "make_description": "",
        "model_code": "",
        "model_description": "POLO",
        "vehicle_type_description": "CAR / SMALL PASSENGER VEHICLE"

Upstream Data

This feature will return structured descriptive data from the registration authority. Use features=additional_upstream_data to receive this payload.

    "additional_upstream_data": {
        "vin": "WVWZZZAWZKU065305",
        "year": "2019",
        "make": "Volkswagen",
        "model": "Polo",
        "badge": "AW",
        "series": "85TSI Comfortline",
        "fuel_type": "95 RON PULP",
        "body_style": "Hatch",
        "transmission": "7 auto",
        "capacity_cc": "1000",
        "colour": "White",
        "title": "2019 Volkswagen AW Polo 85TSI Comfortline 4 Hatch 7sp auto 1.0L 1000cc 3cyl T/Petrol 2018"

Vehicle Age

This feature will return structured data on the age of a vehicle from the registration authority. Use features=vehicle_age to receive this payload.

    "vehicle_age": {
        "compliance_plate": "2019-04",
        "year_of_manufacture": 2019

Writeoff Information

This feature will return information about the write-off status of a vehicle. Use features=writeoff_info

  "writeoff_info": {
        "incident_list": [
            {
                "code": "Repairable Write-off",
                "damage_codes": "I04AI17DI21C",
                "jurisdiction": "VIC",
                "recorded_date": "2024-04-28",
                "type_code": "Collision"
            }
        ]

Registration Status

This feature will return information about the registration status of a vehicle. Use features=registration_status

    "registration_status": {
        "expiry_date": "2024-09-06",
        "status": "REGISTERED"
    }

Build Data

This feature will return the options fitted to the vehicle based on your Factory Build Data. It will show all options, the price and if it is fitted to the vehicle or not. Usefeatures=build_data

"build_data": {
        "vin": "WAUZZZ8V7K1028938",
        "make": "AUDI",
        "model": "A3",
        "features": [
            {
                "code": "0A1",
                "value": "2 doors"
            },
            {
                "code": "0AE",
                "value": "Front stabilizer bar"
            },
            {
                "code": "0B2",
                "value": "Wheelbase"
            },
        ],
        "build_date": "2019-03-20"

Refer to Factory Build Data reference material for more information on supported OEMs.

Odometer History

This feature will return the vehicle's odometer history as captured by registration authorities. Use features=odo_history

"odo_history": [
        {
            "read_date": "2021-02-09",
            "odometer": 56220
        },
        {
            "read_date": "2022-03-08",
            "odometer": 58500
        },
        {
            "read_date": "2023-02-28",
            "odometer": 59882
        }
    ],

This feature is only available in New Zealand

Odometer Prediction

This feature will return the vehicle's predicted odometer based on odometer reads and market data. Use features=odo_prediction

    },
    "odo_prediction": {
        "prediction": 64636,
        "days_since_read": 345,
        "increase_since_read": 4754,
        "avg_yearly": 5030,
        "avg_daily": 13.77,
        "ag_market_avg": 175987
    }      

This feature is only available in New Zealand

Vehicle Safety Risk Ratings (VSRR)

This feature will return the vehicle's Vehicle Safety Risk Ratings (VSRR). Use features=vsrr

 "vsrr": {
        "fuel_economy": {
            "star_rating": 2,
            "consumption": 8.8
        },
        "emissions": {
            "co2": 212,
            "star_rating": 2
        },
        "pollutants": {
            "star_rating": 3,
            "test_regime": "A79/02"
        },
        "safety": {
            "driver": {
                "star_rating": 4,
                "test_regime": "Based on 2023 UCSR rating for 16-19 models"
                

Fittable Options

This feature will return all fittable options for the provided vehicle. Use features=options

 "options": [
                {
                    "detail": "R-Line Package",
                    "price": 1500
                },
                {
                    "detail": "Sound & Vision Package",
                    "price": 1900
                },
                {
                    "detail": "Driver Assistance Package (Polo)",
                    "price": 1500
                },
                {
                    "detail": "Paint - Metallic/Pearl Effect",
                    "price": 500
                }
            ]

This feature is only available in New Zealand

Last updated