UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

ID Search

Powered by EV Database

Unlock compatibility and discover the power of EV Database. 

 

Quickly and easily identify the correct vehicle and its unique ID, and use this as the key to accessing in-depth data on real world range, efficiency, charging and pence-per-mile performance data. 

 

Take advantage of free implementation consultancy and achieve compatibility with your existing data landscape.  

Key Features

Text & Parameter-Based Search

Easily identify the correct EV Database derivative

Compatibility Solved

Enables the use of EV Database data in any data landscape

Confidence Scoring

Provides an array of confidence scored results

Structured Vehicle Descriptions

Manufacturer, model range, derivative, height and length descriptions (as appropriate)

Battery Data

Actual and usable battery capacity and voltage

Technical Data

Gross vehicle weight and drivetrain as homologated

Pricing

PAYG
50p
Per Use
Business
25p
Per Use
Enterprise
12p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)50p60c70c
Business (Per Use)25p30c35c
Enterprise (Per Use)12p15c17c

Documentation

Introduction

This endpoint identifies the matching vehicle in EV Database using a combination of description, technical data and the date of registration.

Header

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

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

Example Request

https://api.oneautoapi.com/evdatabase/uk/idsearch/?manufacturer_desc=fiat&model_range_desc=ducato&derivative_desc=e-ducato&battery_capacity_usable_kwh=76&battery_capacity_kwh=100&battery_volts=400&gross_vehicleweight_kg=3500&drivetrain_desc=Front Wheel Drive&is_current=true&registration_date=2024-01-01&vehicle_type=van

Example Sandbox Request

https://sandbox.oneautoapi.com/evdatabase/uk/idsearch/?manufacturer_desc=fiat&model_range_desc=ducato&derivative_desc=e-ducato&battery_capacity_usable_kwh=76&battery_capacity_kwh=100&battery_volts=400&gross_vehicleweight_kg=3500&drivetrain_desc=Front Wheel Drive&is_current=true&registration_date=2024-01-01&vehicle_type=van

Request Parameters

manufacturer_desc
mandatory, string, e.g. fiat
Manufacturer description
model_range_desc
mandatory, string, e.g. ducato
Model range description
derivative_desc
mandatory, string, e.g. e-ducato
The deriative description
battery_capacity_usable_kwh
optional, string, e.g. 76
Usable capacity (the amount of energy the car can actually draw on to propel itself) in kwh
battery_capacity_kwh
optional, string, e.g. 100
Battery capacity in kwh e.g 100
battery_volts
optional, string, e.g. 400
Nominal battery voltage as defined by the manufacturer
gross_vehicleweight_kg
optional, string, e.g. 3500
Gross vehicle weight in kilograms
drivetrain_desc
optional, string, e.g. Front Wheel Drive
Drivetrain
is_current
optional, string, e.g. true
Is the vehicle currently available to order (includes pre-order open)
registration_date
optional, string, e.g. 2024-01-01
Date the vehicle was first registered in the UK
vehicle_type
optional, string, e.g. van
Vehicle type

Sample Response

{
  "success": true,
  "result": [
    {
      "evdb_vehicle_id": 1234,
      "vehicle_type": "van",
      "manufacturer_desc": "Fiat",
      "model_range_desc": "Ducato",
      "derivative_desc": "e-Ducato",
      "model_length_desc": "M",
      "model_height_desc": "H2",
      "battery_type": "Lithium-ion",
      "battery_capacity_usable_kwh": 42,
      "battery_capacity_kwh": 47,
      "battery_volts": 400,
      "gross_vehicleweight_kg": 3500,
      "drivetrain_desc": "Front Wheel Drive",
      "introduced_date": "2020-12-01",
      "discontinued_date": "null",
      "is_available_to_order": true,
      "confidence_scoring": {
        "manufacturer_desc_score": 100,
        "model_range_desc_score": 100,
        "derivative_desc_score": 100,
        "badged_battery_capacity_kwh_score": 83,
        "battery_capacity_kwh_score": 47,
        "battery_capacity_usable_kwh_score": 66,
        "gross_vehicleweight_kg_score": 100,
        "battery_volts_score": 100,
        "drivetrain_desc_score": 100,
        "availability_score": 100,
        "overall_score": 69.6
      }
    }
  ],
  "error": "If there is an error the message would go here"
}

Response Parameters

success
e.g. true
Whether the api call was successful
evdb_vehicle_id
e.g. 1234
EV Database Vehicle ID
vehicle_type
e.g. van
Class of vehicle.
manufacturer_desc
e.g. Fiat
Manufacturer description
model_range_desc
e.g. Ducato
Model range description.
derivative_desc
e.g. e-Ducato
Derivative description.
model_length_desc
e.g. M
The model length description
model_height_desc
e.g. H2
The model height description
battery_type
e.g. Lithium-ion
Battery type.
battery_capacity_usable_kwh
e.g. 42
Usable capacity (the amount of energy the car can actually draw on to propel itself) in kwh
battery_capacity_kwh
e.g. 47
Battery capacity in kwh
battery_volts
e.g. 400
Voltage of the battery.
gross_vehicleweight_kg
e.g. 3500
Total weight of the vehicle including the Kerb Weight and Payload Weight in kilograms.
drivetrain_desc
e.g. Front Wheel Drive
Drivetrain
introduced_date
e.g. 2020-12-01
The date the vehicle was available in the market from
discontinued_date
e.g. null
The date the vehicle was available to in the market
is_available_to_order
e.g. true
Likelihood this vehicle is currently available to order.
manufacturer_desc_score
e.g. 100
Likelihood this is the chosen manufacturer description based on input parameters. The higher the confidence score the more likely this is the chosen manufacturer.
model_range_desc_score
e.g. 100
Likelihood this is the chosen model range description based on input parameters. The higher the confidence score the more likely this is the chosen model range.
derivative_desc_score
e.g. 100
Likelihood this is the chosen derivative description based on input parameters. The higher the confidence score the more likely this is the chosen derivative.
badged_battery_capacity_kwh_score
e.g. 83
Likelihood this vehicle has the chosen badged battery capacity in kilowatt hours based on input parameters. The higher the confidence score the more likely this is the chosen badged battery capacity.
battery_capacity_kwh_score
e.g. 47
Likelihood this vehicle has the chosen battery capacity in kilowatt hours based on input parameters. The higher the confidence score the more likely this is the chosen battery capacity.
battery_capacity_usable_kwh_score
e.g. 66
Likelihood this vehicle has the chosen usable battery capacity kilowatt based on input parameters. The higher the confidence score the more likely this is the chosen usable battery capacity.
gross_vehicleweight_kg_score
e.g. 100
Likelihood this vehicle has the chosen gross vehicle weight in kilograms based on input parameters. The higher the confidence score the more likely this is the chosen gross vehicle weight.
battery_volts_score
e.g. 100
Likelihood this vehicle has the chosen battery voltage based on input parameters. The higher the confidence score the more likely this is the chosen battery voltage.
drivetrain_desc_score
e.g. 100
Likelihood this vehicle has the chosen drivetrain description based on input parameters. The higher the confidence score the more likely this is the chosen drivetrain description.
availability_score
e.g. 100
The likelihood this vehicle is currently available to order.
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call

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 EV Database

Bi-Directional Charging - Car

Help buyers understand the bi-directional charging capabilities of an electric car, and the potential benefits it could offer as a power source.

Bi-Directional Charging - Van

Help buyers understand the bi-directional charging capabilities of an electric van, and the potential benefits it could offer as a power source.

Core Data - Car

Structured model descriptions, battery size and availability dates/status for cars for your website or application.

Core Data - Van

Structured model descriptions, battery size and availability dates/status for vans for your website or application.

Fast Charging - Car

Help buyers and drivers get to grips with the capabilities and limitations of electric car charging whilst using public charging stations.