Skip to content

Vehicle Database

Paid feature

To access and utilize this API, there are associated costs involved. For more information regarding pricing and to enable access to the API, please contact our team at it@wegroup.be.

Introduction

WeGroup holds a vehicle database of all cars in the world, this database can be used to check, list, retrieve and verify vehicles.

A full example response can be found here: WBA6L7100LFH65459.json.

There are 2 options to retrieve vehicle information:

  1. Retrieve information by VIN.
  2. Manual lookup, by looking up brand, model and series.

Use cases

  • As a SaaS platform I want to provide my customer with a vehicle validation and verification form.

API Documentation

Environment Documentation Link
STAGING https://api.staging.wegroup.be/redoc#tag/vehicle
PRODUCTION https://api.wegroup.be/redoc#tag/vehicle

How to

Search by VIN

First you will search for the VIN and then you can retrieve detailed information by ID.

Request:

curl -X POST \
    "https://$HOST/v1/api/vehicles/search" \
    -H "Authorization: apikey $API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
    "vin_number": "WBA6L7100LFH65459"
    }'

curl -X POST \
    "https://$HOST/v1/api/vehicles/search" \
    -H "Authorization: bearer $ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
    "vin_number": "WBA6L7100LFH65459"
    }'

Response:

{
  "items": [
    {
      "car": {
        "brand": "BMW",
        "series": "3 SERIES",
        "version": "320D140 XDRIVE STEPTRONIC",
        "kw": 140,
        "motor_type": "DIE",
        "series_category": "PASSENGER_CAR",
        "id": "950b13ec-866b-40b9-8bfe-497ddfe604d8",
        "series_id": "36c38122-9a72-11ea-b26b-74c63b4d53f8",
        "model_year": 2019,
        "transmission_type": "auto",
        "cc": 1995,
        "co2": 119,
        "price": 36157,
        "category": "SEDAN",
        "amount_of_seats_incl_driver": 5,
        "is_sportscar": false,
      }
    },
    ...
  ]
}

Request:

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/vin/$VIN/premium?car_id=$CAR_ID" \
    -H "Authorization: apikey $API_TOKEN"

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/vin/$VIN/premium?car_id=$CAR_ID" \
    -H "Authorization: bearer $ACCESS_TOKEN"

Response:

{
  "data": {
    "general": {
        "aedes_parking": "P2",
        "brand": "BMW",
        "brand_logo": "https://files.wegroup.be/logos/vehicle/bmw.svg",
        "febiacid": 236222,
        "id": "950b13ec-866b-40b9-8bfe-497ddfe604d8",
        "meldcode": 5459,
        "model_year": 2019,
        "series": "3 SERIES",
        "series_id": "36c38122-9a72-11ea-b26b-74c63b4d53f8",
        "version": "320D140 XDRIVE STEPTRONIC",
        "wvta": "e1*2007/46*2017*00"
    },
    "origin": {
      "manufacturer": "BMW BAYERISCHE MOTOREN WERKE AG, D-80788 MUENCHEN",
      "manufacturer_origin": "Muenchen 13, Germany",
      "manufacturing_date": "1999-05-01",
      "plant_country": "Germany",
      "plant_city": null
    },
    "vin_info": {
      "wmi": "WBA",
      "vds": "LFH65459",
      "vis": "6L7100"
    },
    "dimensions": {
      "length": {
        "value": 4709,
        "unit": "mm"
      },
      "width": {
        "value": 1827,
        "unit": "mm"
      },

    ...

Manual lookup

1) select the brand

Request:

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/brands" \
    Authorization:"Apikey $API_TOKEN"

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/brands" \
    Authorization:"Bearer $ACCESS_TOKEN"

Response:

{
  ...
  {
      "brand": {
          "alias": null,
          "key": "audi",
          "logo_url": "https://files.wegroup.be/logos/vehicle/audi.svg",
          "name": "Audi"
      }
  },
  ...
}

2) find the correct series

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/brands/audi/series" \
    Authorization:"Apikey $API_TOKEN"

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/brands/audi/series" \
    Authorization:"Bearer $ACCESS_TOKEN"

Response:

...
{
    "series": {
        "brand_key": "audi",
        "id": "36b04698-9a72-11ea-b26b-74c63b4d53f8",
        "name": "A6"
    }
},
...

3) find the correct version

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/series/36b04698-9a72-11ea-b26b-74c63b4d53f8/versions" \
    Authorization:"Apikey $API_TOKEN"

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/series/36b04698-9a72-11ea-b26b-74c63b4d53f8/versions" \
    Authorization:"Bearer $ACCESS_TOKEN"

...
{
    "version": {
        "cc": 1798,
        "co2": 138,
        "id": "5614ac96-9c24-11ea-9bf0-74c63b4d53f8",
        "kw": 140,
        "kwh": null,
        "model_year": 2014,
        "motor_type": "PET",
        "price": 39051.44,
        "transmission_type": "man",
        "version": "1.8TFSI140 S LINE"
    }
},
...

4) retrieve the information of the specific version

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/versions/5614ac96-9c24-11ea-9bf0-74c63b4d53f8/premium" \
    Authorization:"Apikey $API_TOKEN"

curl -X GET \
    "https://$HOST/v1/api/vehicles/automobile/versions/5614ac96-9c24-11ea-9bf0-74c63b4d53f8/premium" \
    Authorization:"Bearer $ACCESS_TOKEN"

{
        "data": {
        "dimensions": null,
        "engine": {
            "battery_capacity": null,
            "battery_info": null,
            "battery_type": null,
            "displacement": {
                "unit": "cc",
                "value": 1798
            },
            "electric_motor_rotations": null,
            "electric_motor_torque": null,
            "emission": {
                "unit": "gCO2/km",
                "value": 138
            },
...