OE Build Decode from VIN

Detailed OE Build Decode from VIN, covering 31 manufacturers in multiple markets.

Europe	North America	Australia
Audi	Alfa Romeo	Audi
BMW	Audi	BMW
Chrysler	BMW	Chrysler
Citroen	Buick	Citroen
Dacia	Chrysler	Dodge
Dodge	Dodge	Ford (US models only)
DS	Ford (EU models only)	Hyundai
Ford	GMC	Jaguar
Hyundai	Jaguar	Jeep
Jaguar	Jeep	Kia
Jeep	Kia	Land Rover
Kia	Land Rover	Mercedes-Benz
Lancia	Lincoln	MINI
Land Rover	Mercedes-Benz	Opel
Lexus	MINI	Peugeot
Mazda	Polestar	Polestar
Mercedes-Benz	RAM	Renault
MINI	Volkswagen	Skoda
Opel	Volvo	Volkswagen
Peugeot		Volvo
Polestar
Renault
SEAT
Skoda
Toyota
Volkswagen
Volvo

Note - this is an asynchronous API which provides several options for receiving the data. Please read our article Working with Asynchronous API Methods before planning your integration.

Key Features

VIN Lookup

VIN lookup for multi-country compatibility

Production Code

Vehicle production code supports accurate parts identification

Factory Codes

Factory option codes, for correlation with other data sources

Vehicle Details

Including colour, engine, transmission and drivetrain.

Manage Risk

Identify vehicle features with a repair risk correlation e.g. ADAS items

Order Parts

Detailed technical and build data means fewer returns and less cost

Pricing

Sample Response

Version

Documentation

Swagger

Introduction

Detailed OE Build Decode from a VIN, covering 27 manufacturers in multiple markets.

Header

When making calls to our API, include the following header:

x-api-key:your-api-key-here

Example Request

https://api.oneautoapi.com/oneauto/oebuilddecode?vehicle_identification_number=ABCDE123456F78910&callback_url=https://webhookexample/l235o5abcde6f/receiver&return_data_in_callback=true

Example Sandbox Request

https://sandbox.oneautoapi.com/oneauto/oebuilddecode?vehicle_identification_number=ABCDE123456F78910&callback_url=https://webhookexample/l235o5abcde6f/receiver&return_data_in_callback=true

Request Parameters

vehicle_identification_number

mandatory, string, e.g. ABCDE123456F78910

Vehicle identification number (VIN).

callback_url

optional, string, e.g. https://webhookexample/l235o5abcde6f/receiver

The callback URL

return_data_in_callback

optional, string, e.g. true

Whether the callback should contain the data from the result.

Sample Response

{
  "success": true,
  "result": {
    "vehicle_identification_number": "ABCDE123456F78910",
    "manufacturer_desc": "Buick",
    "model_range_desc": "Encore",
    "model_desc": "Buick Encore 1.4T AMT(6-speed) Preferred 2020",
    "oem_series_desc": "E1",
    "oem_production_code": "wyxyzpjgj",
    "oem_body_type_desc": "SUV",
    "oem_power_value": 103,
    "oem_fuel_type_desc": "Petrol",
    "oem_engine_size_litres": 1.4,
    "oem_drive_side": "LHD",
    "manufactured_date": "2020-05-08",
    "oem_colour_desc": "Midnight Black Pearlescent",
    "oem_interior_trim_desc": "INTERIOR TRIM CONFIG #14",
    "oem_engine_desc": "ENGINE GAS, 4 CYL, 1.4L, MFI, DOHC, TURBO, VVT, ALUM, GME",
    "oem_transmission_type_desc": "Automatic",
    "oem_drivetrain_desc": "FWD",
    "options": [
      {
        "factory_code": "AKK",
        "factory_desc": "WINDSHIELD STYLE ACOUSTIC PVB"
      }
    ]
  }
}

Response Parameters

success

e.g. true

Whether the api call was successful

vehicle_identification_number

e.g. ABCDE123456F78910

Vehicle identification number (VIN).

manufacturer_desc

e.g. Buick

Manufacturer description

model_range_desc

e.g. Encore

Model range description.

model_desc

e.g. Buick Encore 1.4T AMT(6-speed) Preferred 2020

Model description.

oem_series_desc

e.g. E1

Model series name assigned by the manufacturer.

oem_production_code

e.g. wyxyzpjgj

Production code assigned by the manufacturer

oem_body_type_desc

e.g. SUV

The body type description as supplied by manufacturer

oem_power_value

e.g. 103

Power value provided by the manufacturer, usually in BHP.

oem_fuel_type_desc

e.g. Petrol

The fuel type as supplied by the manufacturer.

oem_engine_size_litres

e.g. 1.4

Engine size provided by the manufacturer, usually in litres.

oem_drive_side

e.g. LHD

Drive side value provided by the manufacturer.

manufactured_date

e.g. 2020-05-08

The date of manufacture

oem_colour_desc

e.g. Midnight Black Pearlescent

The OEM's colour description.

oem_interior_trim_desc

e.g. INTERIOR TRIM CONFIG #14

The interior trim description as supplied by the manufacturer.

oem_engine_desc

e.g. ENGINE GAS, 4 CYL, 1.4L, MFI, DOHC, TURBO, VVT, ALUM, GME

The engine description as supplied by manufacturer

oem_transmission_type_desc

e.g. Automatic

The transmission type description as supplied by manufacturer

oem_drivetrain_desc

e.g. FWD

The drivetrain description as supplied by manufacturer

factory_code

e.g. AKK

The factory code

factory_desc

e.g. WINDSHIELD STYLE ACOUSTIC PVB

Factory description

Status Codes

200

success, chargeable

Request has been successfully received and a response has been sent.

202

accepted, non-chargeable

Request has been received and accepted for processing, but the action has not yet been completed.

204

no content, non-chargeable

Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.

206

partial content, non-chargeable

Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.

400

bad request, non-chargeable

Request was not received e.g. if any required parameters are missing.

403

forbidden, non-chargeable

Request was rejected e.g. if the API key is invalid or the service is not enabled.

429

too many requests, non-chargeable

API key rate limit/quota has been exceeded.

500

internal server error, non-chargeable

We are unable to process the request e.g. if the API is under extremely heavy load.

503

service unavailable, non-chargeable

Service is temporarily unavailable. Contact help@oneautoapi.com

Also Available From One Auto API

One Auto API Limited

Terms Privacy Policy