UK-EN

OE Build Decode

Pricing

PAYG
5p
Per Result

Pricing

PlanGBPEURUSD
PAYG (Per Result)5p6c7c
Business (Per Result)3p4c4c
Enterprise (Per Result)1p1c1c

Documentation

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://bjbiy52iua.execute-api.eu-west-2.amazonaws.com/dev/oneauto/oebuilddecode?vehicle_identification_number=ABCDE123456F78910&callback_url=https://webhookexample/l235o5abcde6f/receiver&return_data_in_callback=true

Example Sandbox Request

https://bjbiy52iua.execute-api.eu-west-2.amazonaws.com/dev/oneauto/oebuilddecode?vehicle_identification_number=ABCDE123456F78910&callback_url=https://webhookexample/l235o5abcde6f/receiver&return_data_in_callback=true&sandbox=1

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