Static Data API Tutorial (beta)

The Static Data API enables you to perform build information lookups for vehicles in your fleet. The data is provided by DAT Group and we offer the convenience of retrieving the information via our platform:

  1. Set up your app container to use your DAT SilverDAT license details
  2. Use our OAuth2 endpoint to receive an Access Token for endpoint authentication
  3. Call the build information endpoint by passing in the VIN (Vehicle Identification Number)
  4. The JSON response provides core build information about your vehicle

We will soon introduce further endpoints next to the build information, such as the residual value calculation.

Production Applications

Note that you can only perform lookups in your live data container. Please get in touch with us on support@high-mobility.com in order to start the activation process.

Prerequisites

Lookups for VINs in most European countries are supported today. In order for you to use this service, you will need a DAT SilverDAT license. For new customers, please get in touch with us in sales@high-mobility.com and we facilitate this process for you.

In order for us to perform the activation, we will configure your app container with your DAT SilverDat customer details.

Billing

Each lookup will count against your billing account in SilverDAT and will be invoiced directly by DAT.

Get an Access Token

To authenticate with the static data endpoint, you first have to create an OAuth2 Access Token.

  1. Go to the "OAuth" tab in your app view
  2. Note the Auth URI and store your Client ID and Client Secret securely
  3. Use your credentials to to create an Access Token with the client_credentials grant:
curl --location 'https://api.high-mobility.com/v1/access_tokens' \
--header 'Content-Type: application/json' \
--data '{"client_id": "a92cf969-e8ff-4ad4-a45f-42930edde12d", "client_secret": "xfVxR6xnlbeVHXkQatRx4FmxSJxFR0-M", "grant_type": "client_credentials"}'
{
    "access_token": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2OTgwNzAwMDEsImlhdCI6MTY5ODA2OTcwMSwiaXNzIjoiaHR0cHM6Ly9zYW5kYm94LmFwaS5oaWdoLW1vYmlsaXR5LmNvbS92MS9hdXRoX3Rva2VucyIsInNjb3BlIjoiZmxlZXQ6Y2xlYXJhbmNlIHZlaGljbGU6ZWxpZ2liaWxpdHktY2hlY2sgdmVoaWNsZTpkYXRhIiwic3ViIjoiMjEwZmMyOTUtZDQ5OS00ZDgwLTk5MWUtZTQ3NTZlZDI3YTZmIiwidmVyIjoxfQ.2neMW6LioKvZYlbSTf-W4GwSHQmMr_8cyXfhyi4XJF-6F4HrvFNIsLlNUa93wp6BiJ_XEythR8DfWh0PrIaHrg",
    "expires_in": 300,
    "scope": "fleet:clearance vehicle:eligibility-check vehicle:data vehicle:static-data",
    "token_type": "bearer"
}

See the authentication tutorial for OAuth2 Client Credentials to get the full details and integration options.

Get the vehicle build information

The general build information is retrieved via the static data endpoint. It's a simple API where all you need to do is to pass in the VIN.

# change ACCESS TOKEN and VIN
curl --location --request GET 'https://api.high-mobility.com/v1/vehicle-static-data/<VIN>' \
--header 'Authorization: Bearer <ACCESS TOKEN>'

Here's a breakdown of the information you currently receive:

JSON keyDescription
manufacturerInformation about the brand and model
equipment.series_equipmentThe series equipmment that the vehicle posesses
equipment.special_equipmentThe special equipmment that the vehicle posesses

Here's an example response:

{
    "manufacturer": {
        "brand": "Jeep",
        "sub_model": "80th Anniversary Plug-In Hybrid 4WD",
        "type_group_name": "Compass",
        "model": "Compass (M7)(2020->)",
        "sales_description": "Compass 1.3 Plug-In Hybrid (EURO 6d) 80th Annivers"
    },
    "equipment": {
        "series_equipment": [
            {
                "description": "airbag driver side/passenger side",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "alarm system",
                "positions": [],
                "manufacturer_id": "LSB"
            },
            {
                "description": "antilock braking system (ABS)",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "automatic air-conditioning system 2-zone",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "automatic headlight control / light sensor",
                "positions": [],
                "manufacturer_id": "LMG"
            },
            {
                "description": "automatic transmission - (6-speed)",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "body: 5-door",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "central locking system with remote control",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "charging cable with three-pin plug (mode 2)",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "cruise control (cruise control)",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "daytime running lights LED",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "door handle outside vehicle colour",
                "positions": [],
                "manufacturer_id": "MNK"
            },
            {
                "description": "driver assistance system: collision warning system (Forward Collision Warning)",
                "positions": [],
                "manufacturer_id": "LSU"
            },
            {
                "description": "driver assistance system: high-beam assistant",
                "positions": [],
                "manufacturer_id": "LMS"
            },
            {
                "description": "driver assistance system: hill-start assist",
                "positions": [],
                "manufacturer_id": "BNG"
            },
            {
                "description": "driver assistance system: intelligent speed adaptation (ISA)",
                "positions": [],
                "manufacturer_id": "NHZ"
            },
            {
                "description": "driver assistance system: lane assist",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "electric motor 44 kW (hybrid drive)",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "Electronic Stability Control (ESP)",
                "positions": [],
                "manufacturer_id": "BNB"
            },
            {
                "description": "electronic traction control",
                "positions": [],
                "manufacturer_id": "BNP"
            },
            {
                "description": "exterior mirror electrically adjustable and heated, both",
                "positions": [],
                "manufacturer_id": "NHJ"
            },
            {
                "description": "exterior mirror electrically folding",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "exterior mirror vehicle colour",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "gasoline particulate filter (GPF)",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "glazing rear darkened",
                "positions": [],
                "manufacturer_id": "GEG"
            },
            {
                "description": "glazing tinted",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "head airbag system",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "head airbag system (windowbag) front + rear",
                "positions": [],
                "manufacturer_id": "CJ2"
            },
            {
                "description": "hybrid 177 kW (engine 1,3 liter - 132 kW)",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "Inductive charging tray for Smartphone",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "info center (EVIC) with 7\"-Display",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "info center with 10,25\" display",
                "positions": [],
                "manufacturer_id": "JAU"
            },
            {
                "description": "Interior filter: pollen filter",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "interior mirror with automatic dimming",
                "positions": [],
                "manufacturer_id": "GNK"
            },
            {
                "description": "Isofix mounts for child seat",
                "positions": [],
                "manufacturer_id": "CGU"
            },
            {
                "description": "Light-alloy rims",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "light and rain sensor",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "low emissions according to emission standard Euro 6d",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "lumbar support seat front left, electrically adjustable",
                "positions": [],
                "manufacturer_id": "JPE"
            },
            {
                "description": "lumbar support seat front left, electrically adjustable, 2-fold",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "model refinement",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "navigation package",
                "positions": [
                    {
                        "description": "driver assistance system: traffic sign detection (TSR)"
                    },
                    {
                        "description": "DAB-Tuner (radio reception digital)"
                    },
                    {
                        "description": "hands-free system UConnect (with Bluetooth interface)"
                    },
                    {
                        "description": "multi-media interface (USB / AUX-IN / SD card interface)"
                    },
                    {
                        "description": "Smartphone interface (Apple CarPlay & Android Auto)"
                    },
                    {
                        "description": "Audio navigation system: UConnect navigation system, DAB, Bluetooth (touchscreen 10,1 inch)"
                    }
                ],
                "manufacturer_id": null
            },
            {
                "description": "parking brake electromechanical",
                "positions": [],
                "manufacturer_id": "XC4"
            },
            {
                "description": "Parkpilot system front and rear",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "passenger-side airbag deactivatable",
                "positions": [],
                "manufacturer_id": "CGZ"
            },
            {
                "description": "Plug-in hybrid technology",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "power outlet 230V",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "power steering electronically controlled",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "radio preparation, 6 speaker(s)",
                "positions": [],
                "manufacturer_id": "RCG"
            },
            {
                "description": "rear lights LED",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "rear seat backrests split/folding",
                "positions": [],
                "manufacturer_id": "CFN"
            },
            {
                "description": "roof rails",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "seat covers/upholstery: cloth/imitation leather",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "seatback front right hinged",
                "positions": [],
                "manufacturer_id": "CDW"
            },
            {
                "description": "shut-down / start system Keyless Go",
                "positions": [],
                "manufacturer_id": "GXD"
            },
            {
                "description": "sidebag",
                "positions": [],
                "manufacturer_id": "CJ1"
            },
            {
                "description": "sidebag front",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "start/stop system",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "steering column (steering wheel) mechanic. adjustable",
                "positions": [],
                "manufacturer_id": "SUD"
            },
            {
                "description": "steering wheel with multiple function",
                "positions": [],
                "manufacturer_id": "RDZ"
            },
            {
                "description": "sun visors with mirror",
                "positions": [],
                "manufacturer_id": "GNC"
            },
            {
                "description": "tire 235/55 R18 ...V",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "tire pressure control system",
                "positions": [],
                "manufacturer_id": "XGM"
            },
            {
                "description": "turn signal light in exterior mirror integrated",
                "positions": [],
                "manufacturer_id": "LEB"
            },
            {
                "description": "Type of drive: all-wheel drive",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "wheelbase 2636 mm",
                "positions": [],
                "manufacturer_id": null
            },
            {
                "description": "window lifter electric front",
                "positions": [],
                "manufacturer_id": "JP3"
            },
            {
                "description": "windshield wiper with rain sensor",
                "positions": [],
                "manufacturer_id": "JHC"
            }
        ],
        "special_equipment": [
            {
                "description": "2-colour paintwork",
                "positions": [],
                "manufacturer_id": "MXS"
            },
            {
                "description": "tire repair kit",
                "positions": [],
                "manufacturer_id": "XFP"
            },
            {
                "description": "Winter package",
                "positions": [
                    {
                        "description": "windshield wiper heated"
                    },
                    {
                        "description": "seat heating front"
                    },
                    {
                        "description": "shift/selector lever leather"
                    },
                    {
                        "description": "steering wheel heated"
                    },
                    {
                        "description": "steering wheel (leather)"
                    }
                ],
                "manufacturer_id": "AAC"
            }
        ]
    }
}