Detailed Specifications Data

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

You can follow the steps outlined below to receive your detailed specifications payload.

Using the Detailed Specifications API and Vehicle Search endpoints with the Jato parameter requires a commercial agreement between you and Jato. The agreed catalogue data is then served via AutoGrabs APIs on this endpoint. The content of the response will depend on your specific plan with Jato. For details on accessing this API, please contact AutoGrab.

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

Registration Search

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

VIN Search

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

Text Search

GET /v2/vehicles?region=au&search=2023 Hyundai Santa Fe MX5.V1 &catalogue=jato

Example Workflow

In this scenario, we will use a text search to request the ID.

You would form your CURL

curl --location 'https://api.autograb.com.au/v2/vehicles?region=au&search=2023%20Hyundai%20Santa%20Fe%20MX5.V1%20&catalogue=jato' \
--header 'apikey: ***APIKEY'

And receive the following response

{
    "success": true,
    "vehicles": [
        {
            "id": "2023-771102220220919",
            "legacy_id": "2023-771102220220919",
            "badge": null,
            "make": "Hyundai",
            "model": "Santa Fe",
            "series": "TM.V4",
            "title": "2023 Hyundai Santa Fe 3.5 MPi Auto TM.V4 MY2023",
            "year": "2023",
            "body_config_type": null,
            "body_type": "SUV",
            "drive_type": "Front Wheel Drive",
            "engine_type": "Piston",
            "fuel_type": "Petrol",
            "transmission_type": "Automatic",
            "wheelbase_type": null,
            "capacity_cc": 3470,
            "power_kw": 200,
            "torque_nm": 200,
            "range": null,
            "num_cylinders": 6,
            "num_doors": 5,
            "num_gears": 8,
            "num_seats": 7,
            "model_year": "MY23",
            "release_month": 9,
            "release_year": 2022,
            "rrp": 46050
        }
    ],
    "total": 1,
    "confidence": "standard"
}

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.

Receiving a "total" greater then one is not an issue if you confidence also recieved is "standard". This means that there are potential variants with nuanced differences available. Select the first one as the list is ranked by confidence.

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 the correct vehicle?” then allow the user to correct it with the additional results in this array.

Consider halting the process if your "confidence" is not "standard." This means the IDs returned are more likely to be incorrect. In this scenario, you have generally not given the text-matching system a detailed description enough to make a confident match. Consider using a registration lookup to enhance the detail available from the matcher.

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

A registration lookup is a separate commercial agreement from the general detailed specification agreement. Speak to your account executive to understand your options.

Request Detailed Specification

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

Branding Requirements

If you use the Detailed Specifications on a dealership website, you are required to display a "Powered by JATO" and accompanying logo, as below. You can download a high-definition version here.

33KB

JATO_RGB_LOGO (3) (1).png

image

The approved logo to be displayed on your dealership website

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 detailed specification 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 particular items as well as the inclusion of the "type".

{
    "success": true,
    "specs": [
        {
            "category": "Version",
            "description": "Make",
            "value": "Volkswagen",
            "location": null
        },
        {
            "category": "Version",
            "description": "Model",
            "value": "Polo",
            "location": null
        },
        {
            "category": "Version",
            "description": "Version",
            "value": "85TSI Comfortline DSG",
            "location": null
        },
        {
            "category": "Version",
            "description": "Body type",
            "value": "hatchback",
            "location": null
        },
        {
            "category": "Version",
            "description": "Seating capacity",
            "value": "5",
            "location": null
        },
        {
            "category": "Equipment",
            "description": "Air Conditioning type",
            "value": "manual",
            "location": null
        },
        {
            "category": "Equipment",
            "description": "Front and rear power windows",
            "value": "S",
            "location": "F"
        },
    ],
    "confidence": "standard"
}

The standard Website Specification pack includes the following categories and counts of included items.

The standard Website Specification pack includes the following categories and counts of included items.

Version: 12 items

Equipment: 28 items

Audio & Communication: 23 items

Interior design: 30 items

Exterior design: 20 items

Primary safety: 24 items

Secondary safety: 14 items

Loadspace: 2 items

Engine & Transmission: 31 items

Hybrid System: 1 item

Environmental Impact: 6 items

Safety: 16 items

Dimensions & Weights: 22 items

Warranty & Servicing: 12 items

Lighting: 2 items