Query car details

Car data can be useful when you want to display more information about the car. You can access data using the car query or get even more data with carPremium. Please contact us for more information on how to get access to our premium data set. You can see a live example with all available output parameters here.

Explore on the playground View example

Query

To get specific details of a car you need to provide a carId. This id can be obtained by using the carList query.

Arguments

id • id

Car ID

externalId • int

Deprecated. We will ignore it.

Frequently used fields

id • id

Cars unique ID

naming • object • CarNaming

Naming of a car

connectors • list • [CarPlug]

Available connectors for a car

availability • object • CarAvailability

Availability of a car

Other fields

adapters • list • [CarPlug]

List of adapters of connectors available for a car

battery • object • CarBattery

Battery of a car

body • object • CarBody

Body of a car

performance • object • CarPerformance

Performance of a car

range • object • CarRange

Range of a car

media • object • CarMedia

Media of a car

routing • object • CarRouting

Routing of a car

connect • object • Connect

Information about vehicle connectivity

externalId • string

Deprecated

ID provided by a car data source as the row ID

make • string

Deprecated

Car manufacturer

carModel • string

Deprecated

Car model

edition • string

Deprecated

Car edition

chargetripEdition • string

Deprecated

Car model edition. Added by Chargetrip as an alternative for when a car manufacturer does not provide an edition name, or uses the same edition name across all trims or consecutive years

version • string

Deprecated

Car version

chargetripRange • object • ChargetripRange

Deprecated

Chargetrip's custom real world range provides a carefully calculated display range for all EV models. This is based on our own research and driving data

fastChargingSupport • boolean

Deprecated

Cars that support fast charging have a minimum charging speed of 43 kWh

mode • enum • CarMode

Deprecated

Current production mode of a car

seats • int

Deprecated

Number of seats

weight • float

Deprecated

Weight in kg

height • int

Deprecated

Height in mm

width • int

Deprecated

Width in mm

batteryUsableKwh • float

Deprecated

Usable battery capacity in kWh

batteryFullKwh • float

Deprecated

Full battery capacity in kWh

batteryEfficiency • object • CarBatteryEfficiency

Deprecated

Battery efficiency in the city, highway and combined depending on weather conditions

acceleration • float

Deprecated

Acceleration time from 0 to 100 km/h

topSpeed • float

Deprecated

Maximum car speed in km/h

power • float

Deprecated

Power of a car in Kw

torque • float

Deprecated

Engine torque

consumption • object • CarExtraConsumption

Deprecated

Extra consumption model

petrolConsumption • float

Deprecated

Amount of petrol a similar petrol car would consume per 100 km

chargingOffset • json

Deprecated

A list of offset data for different charging speeds

images • list • [CarImage]

Deprecated

Images of a car

imagesData • object • CarImageData

Deprecated

Images of a car in structured data

Response

If successful, the HTTP status code in the response header is 200 and the response body contains the attributes you requested.

If unsuccessful, the header status code is an error code and the response body contains an error response object. The error response object can be any of the ones below.

Errors & warnings

Error

CAR_NOT_FOUND
No car was found with the provided ID
Error

ERROR_FORBIDDEN_MESSAGE
You are forbidden to execute this operation
Error

MISSING_REQUIRED_PARAMETERS
Missing required parameter(s): $PARAMETERS

 Query 
query car {  car(id: "5d161be5c9eef46132d9d20a") {    id    naming {      make      model      version      edition      chargetrip_version    }    connectors {      standard      power      time      speed    }    adapters {      standard      power      time      speed    }    battery {      usable_kwh      full_kwh    }    body {      width      height      weight      seats    }    availability {      status    }    performance {      acceleration      top_speed    }    range {      real      real_is_estimated      worst {        highway        city        combined      }      best {        highway        city        combined      }      chargetrip_range {        worst        best      }    }    media {      evdb_details_url      image {        id        type        url        height        width        thumbnail_url        thumbnail_width        thumbnail_height      }      brand {        id        type        url        height        width        thumbnail_url        thumbnail_width        thumbnail_height      }      image_list {        id        type        url        height        width        thumbnail_url        thumbnail_width        thumbnail_height      }      video {        id        url      }      video_list {        id        url      }    }    routing {      fast_charging_support    }  }}

 Response 
{  "data": {    "car": {      "id": "5d161be5c9eef46132d9d20a",      "naming": {        "make": "Tesla",        "model": "Model S",        "version": "75D",        "edition": null,        "chargetrip_version": "75D (2016-2019)"      },      "connectors": [        {          "standard": "IEC_62196_T2",          "power": 16.5,          "time": 315,          "speed": 72        },        {          "standard": "TESLA_S",          "power": 120,          "time": 40,          "speed": 390        }      ],      "adapters": [        {          "standard": "IEC_62196_T2_COMBO",          "power": 80,          "time": 45,          "speed": 350        },        {          "standard": "CHADEMO",          "power": 80,          "time": 45,          "speed": 350        },        {          "standard": "IEC_62196_T2",          "power": 16.5,          "time": 315,          "speed": 55        }      ],      "battery": {        "usable_kwh": 72.5,        "full_kwh": 75      },      "body": {        "width": 2037,        "height": 1445,        "weight": 2183,        "seats": 5      },      "availability": {        "status": 0      },      "performance": {        "acceleration": 4.4,        "top_speed": 225      },      "range": {        "real": 380,        "real_is_estimated": false,        "worst": {          "highway": 275,          "city": 370,          "combined": 320        },        "best": {          "highway": 350,          "city": 540,          "combined": 435        },        "chargetrip_range": {          "worst": 334,          "best": 387        }      },      "media": {        "evdb_details_url": null,        "image": null,        "brand": null,        "image_list": null,        "video": null,        "video_list": null      },      "routing": {        "fast_charging_support": true      }    }  }}