Detailed Specifications Data

Use this if you have a configuration to receive detailed specifications powered by Jato.

In order to receive your detailed specifications payload you can follow the steps outlined below.

TLDR?

Lookup the rego while including the catalogue=jato param.

https://api.autograb.com.au/v2/vehicles/registrations/CCU542?region=au&state=VIC&catalogue=jato

Lookup the detailed specifications using the ID you got from your lookup

https://api.autograb.com.au/v2/vehicles/2022-831964720220610/detailed-specs?region=au

Search For The Vehicle

Supported Methods

Right now there are two supported vehicle discovery methods.

GET /v2/vehicles/registrations/CCU542?region=au&state=VIC&catalogue=jato

GET /v2/vehicles/vins/LRW3F7FA1MC176142?region=au&catalogue=jato

There is upcoming support for free text searching

Example Workflow

In this scenario, we will use a vehicle registration to request the ID.

You would form your CURL

curl --location 'https://api.autograb.com.au/v2/vehicles/registrations/CCU542?region=au&state=VIC&catalogue=jato' \
--header 'apikey: ****APIKEY'

And receive the following response

{
    "success": true,
    "vehicle": {
        "id": "2022-831964720220610",
        "region": "au",
        "title": "2022 Tesla Model Y Rear-Wheel Drive MY2022",
        "year": "2022",
        "make": "Tesla",
        "model": "Model Y",
        "badge": "Rear-Wheel Drive",
        "series": null,
        "model_year": "MY22",
        "release_month": 6,
        "release_year": 2022,
        "body_type": "SUV",
        "transmission": "Automatic",
        "transmission_type": "Automatic",
        "wheelbase": null,
        "wheelbase_type": null,
        "fuel": "Electric",
        "fuel_type": "Electric",
        "engine": "Electric",
        "engine_type": "Electric",
        "drive": "RWD",
        "drive_type": "Rear Wheel Drive",
        "num_doors": 5,
        "num_seats": 5,
        "num_gears": 1,
        "num_cylinders": null,
        "capacity_cc": null,
        "power_kw": 220,
        "torque_nm": 220,
        "range": null,
        "options": []
    },
    "upstream_vehicle": "2022 Tesla Model Y 4 Wagon 1sp auto Electric 2022",
    "vin": "LRWYHCFS6NC428809",
    "colour": "Grey",
    "confidence": "standard",
    "additional_vehicles": []
}

If you would like to receive additional lower confidence matches to power your UI you can enhance your request with our prefer_more_results parameter.

curl --location 'https://api.autograb.com.au/v2/vehicles/registrations/CCU542?region=au&state=VIC&prefer_more_results=true&catalogue=jato' \
--header 'apikey: ****APIKEY'

Consider leveraging this feature in your user interface with a user input request. For example, “Is this not the correct vehicle”, then allow the user to correct it with the additional results in this array.

Request Detailed Specification

Now that you have isolated the Jato Code or AutoGrab ID you can request the Detailed specs.

Example Workflow

To request detailed specs use the Jato Code or AutoGrab ID you received from the earlier vehicle discovery step.

curl --location 'https://api.autograb.com.au/v2/vehicles/2022-831964720220610/detailed-specs?region=au' \
--header 'apikey: ****APIKEY'

You will receive your pre-defined spec payload. An example response is below.

The response you receive will be defined by the configuration we store for you based on your specific business case. This applies to the inclusion of specific items as well as the inclusion of the "type".

 {
    "success": true,
    "specs": [
        {
            "description": "Local make name",
            "value": "Tesla",
            "location": null,
            "type": "spec"
        },
        {
            "description": "Local model name",
            "value": "Model Y",
            "type": "spec"
        },
        {
            "description": "Interior Trim",
            "value": "Exposed Metal"
            "type": "feature"
        },
        {
            "description": "Local version name",
            "value": "Rear-Wheel Drive",
            "type": "spec"
        },
        {
            "description": "Model year (including fractional)",
            "value": "2022",
            "type": "spec"
        },
        {
            "description": "Local number of doors",
            "value": "5",
            "type": "spec"
        }
    ],
    "confidence": "standard"
}