Vehicle Valuation

Vehicle Valuation API will return some very basic vehicle details and a list of submodels with valuation information for each.

Request

<site>/a/vehicle:valuation?key=<Developer API Key>&plate=<Plate|VIN>

Response

The default response format is JSON. For XML add &f=xml to the request.

Note: If CarJam does not have all the data to return or the data is outdated we will start fetching the data. While we are busy doing so we will reply with null response. Additionally, we will return Refresh: HTTP header for you to read. Refresh headers signals you how long to wait before attempting to do another request. If you don't want to read Refresh header please wait at least one second before coming back.

Eventually, you will receive a response. It would look something like:

Response example

{
    "plate": "CBC193",
    "year_of_manufacture": "2004",
    "make": "VOLKSWAGEN",
    "model": "GOLF",
    "submodel": "1.6 FSI TIP",
    "vin": "WVWZZZ1KZ4W084761",
    "chassis": "",
    "engine_no": "BAG069411",
    "cc_rating": "1598",
    "main_colour": "Silver",
    "second_colour": "",
    "country_of_origin": "GER",
    "no_of_seats": "5",
    "fuel_type": "01",
    "alternative_fuel_type": "",
    "previous_country_of_registration": "",
    "latest_odometer_reading": "148974",
    "transmission": "6-gear automatic",
    "valuation": {
        "variants": [
            {
                "make": "VOLKSWAGEN",
                "family": "GOLF",
                "model": "FSI 1.6 5DR H/B AUTO",
                "badge": "FSI",
                "bodystyle": "HATCHBACK",
                "trans": "AUTO",
                "cc": 1598,
                "fuel": "PETROL",
                "enginetype": "FSI",
                "doors": 5,
                "cyls": 4,
                "commpass": "P",
                "usedimport": 1,
                "options": "",
                "year": 2004,
                "month": 0,
                "yearnvi": "VE204F",
                "isnew": 1,
                "newprice": 37490,
                "dgest": 5600,
                "notes": "",
                "ovcc_cc": 1600,
                "ovcc_make": "VOLKSWAGEN",
                "ovcc_model": "GOLF",
                "ovcc_year": 2004,
                "ovcc_body": "HA",
                "avg_kms": 150145.52975171,
                "is_bike": false,
                "kms": 149000,
                "dg_kms": "148974",
                "age": 13,
                "dgest_kms": 5600
            },
            {
                "make": "VOLKSWAGEN",
                "family": "GOLF",
                "model": "FSI 1.6 5DR H/B MANUAL",
                "badge": "FSI",
                "bodystyle": "HATCHBACK",
                "trans": "MANUAL",
                "cc": 1598,
                "fuel": "PETROL",
                "enginetype": "FSI",
                "doors": 5,
                "cyls": 4,
                "commpass": "P",
                "usedimport": 1,
                "options": "",
                "year": 2004,
                "month": 0,
                "yearnvi": "VE104F",
                "isnew": 1,
                "newprice": 34990,
                "dgest": 5300,
                "notes": "",
                "ovcc_cc": 1600,
                "ovcc_make": "VOLKSWAGEN",
                "ovcc_model": "GOLF",
                "ovcc_year": 2004,
                "ovcc_body": "HA",
                "avg_kms": 150145.52975171,
                "is_bike": false,
                "kms": 149000,
                "dg_kms": "148974",
                "age": 13,
                "dgest_kms": 5300
            },
            {
                "make": "VOLKSWAGEN",
                "family": "GOLF",
                "model": "IMPORT 1.6 5DR H/B AUTO",
                "badge": "IMPORT",
                "bodystyle": "HATCHBACK",
                "trans": "AUTO",
                "cc": 1600,
                "fuel": "PETROL",
                "enginetype": "",
                "doors": 5,
                "cyls": 4,
                "commpass": "P",
                "usedimport": 0,
                "options": "",
                "year": 2004,
                "month": 0,
                "yearnvi": "YET04A",
                "isnew": 1,
                "newprice": 0,
                "dgest": 4700,
                "notes": "",
                "ovcc_cc": 1600,
                "ovcc_make": "VOLKSWAGEN",
                "ovcc_model": "GOLF",
                "ovcc_year": 2004,
                "ovcc_body": "HA",
                "avg_kms": 150145.52975171,
                "is_bike": false,
                "kms": 149000,
                "dg_kms": "148974",
                "age": 13,
                "dgest_kms": 4700
            }
        ],
        "avg_kms": 150145.52975171,
        "dg_kms": "148974"
    }
}

Error response example

{
    "code": -1,
    "message": "Missing Developer Key."
}