Query vehicle details
Vehicle data is useful to display more information about a vehicle. The vehicle query is used to access this data. Looking for more data? Use the vehiclePremium query. Please contact us for more information on how to get access to our premium data set.
Query vehicle details
Render all the ins and outs about a vehicle.
Query
To get specific details about a vehicle it is necessary to provide a vehicleId. This id can be obtained by using the vehicleList query.
Arguments
id • ID
• Required
Vehicles unique ID.
country • CountryCodeAlpha2
ISO-3166 alpha-2 country code to apply localization on vehicle data if available.
Show CountryCodeAlpha2 enum values
AD
AE
AF
AG
AI
AL
AM
AN
AO
AQ
AR
AS
AT
AU
AW
AX
AZ
BA
BB
BD
BE
BF
BG
BH
BI
BJ
BL
BM
BN
BO
BQ
BR
BS
BT
BV
BW
BY
BZ
CA
CC
CD
CF
CG
CH
CI
CK
CL
CM
CN
CO
CR
CS
CU
CV
CW
CX
CY
CZ
DE
DJ
DK
DM
DO
DZ
EC
EE
EG
EH
ER
ES
ET
FI
FJ
FK
FM
FO
FR
GA
GB
GD
GE
GF
GG
GH
GI
GL
GM
GN
GP
GQ
GR
GS
GT
GU
GW
GY
HK
HM
HN
HR
HT
HU
ID
IE
IL
IM
IN
IO
IQ
IR
IS
IT
JE
JM
JO
JP
KE
KG
KH
KI
KM
KN
KP
KR
KW
KY
KZ
LA
LB
LC
LI
LK
LR
LS
LT
LU
LV
LY
MA
MC
MD
ME
MF
MG
MH
MK
ML
MM
MN
MO
MP
MQ
MR
MS
MT
MU
MV
MW
MX
MY
MZ
NA
NC
NE
NF
NG
NI
NL
NO
NP
NR
NU
NZ
OM
PA
PE
PF
PG
PH
PK
PL
PM
PN
PR
PS
PT
PW
PY
QA
RE
RKS
RO
RS
RU
RW
SA
SB
SC
SD
SE
SG
SH
SI
SJ
SK
SL
SM
SN
SO
SR
SS
ST
SV
SX
SY
SZ
TC
TD
TF
TG
TH
TJ
TK
TL
TM
TN
TO
TR
TT
TV
TW
TZ
UA
UG
UM
US
UY
UZ
VA
VC
VE
VG
VI
VN
VU
WF
WS
YE
YT
ZA
ZM
ZW
Frequently used fields
id • ID
Vehicles unique ID.
naming • VehicleNaming
Naming of the vehicle.
make • String
Vehicle manufacturer name.
model • String
Vehicle model name.
version • String
Version, edition or submodel of the vehicle.
edition • String
Another submodel level of the vehicle.
chargetrip_version • String
Vehicle model version. Added by Chargetrip as an alternative for when a vehicle manufacturer does not provide an version name, or uses the same version name across all trims or consecutive years.
connectors • VehicleConnector
Available connectors for the vehicle.
standard • ConnectorType
Connector type, known as connector standard in OCPI.
Show ConnectorType enum values
CHADEMO
The connector type is CHAdeMO, DC
DOMESTIC_A
Standard/domestic household, type "A", NEMA 1-15, 2 pins
DOMESTIC_B
Standard/domestic household, type "B", NEMA 5-15, 3 pins
DOMESTIC_C
Standard/domestic household, type "C", CEE 7/17, 2 pins
DOMESTIC_D
Standard/domestic household, type "D", 3 pins
DOMESTIC_E
Standard/domestic household, type "E", CEE 7/5 3 pins
DOMESTIC_F
Standard/domestic household, type "F", CEE 7/4, Schuko, 3 pins
DOMESTIC_G
Standard/domestic household, type "G", BS 1363, Commonwealth, 3 pins
DOMESTIC_H
Standard/domestic household, type "H", SI-32, 3 pins
DOMESTIC_I
Standard/domestic household, type "I", AS 3112, 3 pins
DOMESTIC_J
Standard/domestic household, type "J", SEV 1011, 3 pins
DOMESTIC_K
Standard/domestic household, type "K", DS 60884-2-D1, 3 pins
DOMESTIC_L
Standard/domestic household, type "L", CEI 23-16-VII, 3 pins
DOMESTIC_M
Standard/Domestic household, type "M", BS 546, 3 pins
DOMESTIC_N
Standard/Domestic household, type "N", NBR 14136, 3 pins
DOMESTIC_O
Standard/Domestic household, type "O", TIS 166-2549, 3 pins
IEC_60309_2_single_16
IEC 60309-2 Industrial connector single phase 16 amperes (usually blue)
IEC_60309_2_three_16
IEC 60309-2 Industrial connector three phase 16 amperes (usually red)
IEC_60309_2_three_32
IEC 60309-2 Industrial connector three phase 32 amperes (usually red)
IEC_60309_2_three_64
IEC 60309-2 Industrial connector three phase 64 amperes (usually red)
IEC_62196_T1
IEC 62196 Type 1 "SAE J1772"
IEC_62196_T1_COMBO
Combo Type 1 based, DC
IEC_62196_T2
IEC 62196 Type 2 "Mennekes"
IEC_62196_T2_COMBO
Combo Type 2 based, DC
IEC_62196_T3A
IEC 62196 Type 3A
IEC_62196_T3C
IEC 62196 Type 3C "Scame"
PANTOGRAPH_BOTTOM_UP
On-board bottom-up-pantograph typically for bus charging
PANTOGRAPH_TOP_DOWN
Off-board top-down-pantograph typically for bus charging
TESLA_R
Tesla connector "Roadster"-type (round, 4 pins)
TESLA_S
Tesla connector "Model-S"-type (oval, 5 pins)
GB_T
The connector type is GB_T (Chinese standard), DC
CHAOJI
The ChaoJi connector. The new generation charging connector, harmonized between CHAdeMO and GB/T. DC.
NEMA_5_20
The connector type is NEMA 5-20, 3 pins
NEMA_6_30
The connector type is NEMA 6-30, 3 pins
NEMA_6_50
The connector type is NEMA 6-50, 3 pins
NEMA_10_30
The connector type is NEMA 10-30, 3 pins
NEMA_10_50
The connector type is NEMA 10-50, 3 pins
NEMA_14_30
The connector type is NEMA 14-30, 3 pins, rating of 30 A
NEMA_14_50
The connector type is NEMA 14-50, 3 pins, rating of 50 A
power • Float
Usable electric power in kW.
max_electric_power • Float
Maximum electric power in kW.
time • Int
Time it takes to charge from 10 to 80% with a fast charger, shown in minutes.
speed • Float
Charging speed, default in kmph.
Show arguments
unit • SpeedUnit
Show SpeedUnit enum values
kilometers_per_hour
Return the speed in kilometers per hour
miles_per_hour
Return the speed in miles per hour
availability • VehicleAvailability
Availability of the vehicle.
status • VehicleAvailabilityStatus
Availability of the vehicle.
Show VehicleAvailabilityStatus enum values
no_longer_available
Vehicle no longer for sale in any market / region.
available
Vehicle currently for sale in at least one market / region.
release_date_announced_preorderable
Vehicle expected in market from Date_From (estimated), pre-order open.
release_date_announced
Vehicle expected in market from Date_From (estimated), pre-order unknown or not open.
concept_vehicle_preorderable
Concept vehicle, nearing production and/or confirmed, pre-order open.
concept_vehicle
Concept vehicle, nearing production and/or confirmed, pre-order unknown or not open.
concept_vehicle_release_date_tba_preorderable
Concept vehicle, not close to production and/or unconfirmed, pre-order open.
concept_vehicle_release_date_tba
Concept vehicle, not close to production and/or unconfirmed, pre-order unknown.
uncertain
Status uncertain, introduction date and/or pricing unclear.
Other fields
drivetrain • VehicleDrivetrain
Drivetrain of the vehicle.
type • VehicleDrivetrainType
Type of drivetrain.
Show VehicleDrivetrainType enum values
BEV
Battery Electric Vehicle.
EREV
Extended Range Electric Vehicle.
HEV
Hybrid Electric Vehicle.
PHEV
Plug-in Hybrid Electric Vehicle.
adapters • VehicleConnector
Adapters for the connectors of the vehicle.
standard • ConnectorType
Connector type, known as connector standard in OCPI.
Show ConnectorType enum values
CHADEMO
The connector type is CHAdeMO, DC
DOMESTIC_A
Standard/domestic household, type "A", NEMA 1-15, 2 pins
DOMESTIC_B
Standard/domestic household, type "B", NEMA 5-15, 3 pins
DOMESTIC_C
Standard/domestic household, type "C", CEE 7/17, 2 pins
DOMESTIC_D
Standard/domestic household, type "D", 3 pins
DOMESTIC_E
Standard/domestic household, type "E", CEE 7/5 3 pins
DOMESTIC_F
Standard/domestic household, type "F", CEE 7/4, Schuko, 3 pins
DOMESTIC_G
Standard/domestic household, type "G", BS 1363, Commonwealth, 3 pins
DOMESTIC_H
Standard/domestic household, type "H", SI-32, 3 pins
DOMESTIC_I
Standard/domestic household, type "I", AS 3112, 3 pins
DOMESTIC_J
Standard/domestic household, type "J", SEV 1011, 3 pins
DOMESTIC_K
Standard/domestic household, type "K", DS 60884-2-D1, 3 pins
DOMESTIC_L
Standard/domestic household, type "L", CEI 23-16-VII, 3 pins
DOMESTIC_M
Standard/Domestic household, type "M", BS 546, 3 pins
DOMESTIC_N
Standard/Domestic household, type "N", NBR 14136, 3 pins
DOMESTIC_O
Standard/Domestic household, type "O", TIS 166-2549, 3 pins
IEC_60309_2_single_16
IEC 60309-2 Industrial connector single phase 16 amperes (usually blue)
IEC_60309_2_three_16
IEC 60309-2 Industrial connector three phase 16 amperes (usually red)
IEC_60309_2_three_32
IEC 60309-2 Industrial connector three phase 32 amperes (usually red)
IEC_60309_2_three_64
IEC 60309-2 Industrial connector three phase 64 amperes (usually red)
IEC_62196_T1
IEC 62196 Type 1 "SAE J1772"
IEC_62196_T1_COMBO
Combo Type 1 based, DC
IEC_62196_T2
IEC 62196 Type 2 "Mennekes"
IEC_62196_T2_COMBO
Combo Type 2 based, DC
IEC_62196_T3A
IEC 62196 Type 3A
IEC_62196_T3C
IEC 62196 Type 3C "Scame"
PANTOGRAPH_BOTTOM_UP
On-board bottom-up-pantograph typically for bus charging
PANTOGRAPH_TOP_DOWN
Off-board top-down-pantograph typically for bus charging
TESLA_R
Tesla connector "Roadster"-type (round, 4 pins)
TESLA_S
Tesla connector "Model-S"-type (oval, 5 pins)
GB_T
The connector type is GB_T (Chinese standard), DC
CHAOJI
The ChaoJi connector. The new generation charging connector, harmonized between CHAdeMO and GB/T. DC.
NEMA_5_20
The connector type is NEMA 5-20, 3 pins
NEMA_6_30
The connector type is NEMA 6-30, 3 pins
NEMA_6_50
The connector type is NEMA 6-50, 3 pins
NEMA_10_30
The connector type is NEMA 10-30, 3 pins
NEMA_10_50
The connector type is NEMA 10-50, 3 pins
NEMA_14_30
The connector type is NEMA 14-30, 3 pins, rating of 30 A
NEMA_14_50
The connector type is NEMA 14-50, 3 pins, rating of 50 A
power • Float
Usable electric power in kW.
max_electric_power • Float
Maximum electric power in kW.
time • Int
Time it takes to charge from 10 to 80% with a fast charger, shown in minutes.
speed • Float
Charging speed, default in kmph.
Show arguments
unit • SpeedUnit
Show SpeedUnit enum values
kilometers_per_hour
Return the speed in kilometers per hour
miles_per_hour
Return the speed in miles per hour
battery • VehicleBattery
Battery of the vehicle.
full_kwh • Float
Full battery capacity in kWh.
usable_kwh • Float
Usable battery capacity in kWh.
body • VehicleBody
Body of the vehicle.
width • Float
Width with folded mirrors, default in mm.
Show arguments
unit • MeasurementUnit
Show MeasurementUnit enum values
millimeter
Return the measurement in millimeters
inch
Return the measurement in inches
height • Float
Height (average height for adjustable suspensions), default in mm.
Show arguments
unit • MeasurementUnit
Show MeasurementUnit enum values
millimeter
Return the measurement in millimeters
inch
Return the measurement in inches
weight • VehicleBodyWeight
Weight (unladen), default in kg.
minimum • Float
Minimum weight, default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms
pound
Return the weight in pounds
nominal • Float
Nominal weight, default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms
pound
Return the weight in pounds
maximal • Float
Maximal weight, default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms
pound
Return the weight in pounds
seats • Int
Number of seats.
performance • VehiclePerformance
Performance of the vehicle.
acceleration • Float
Acceleration in seconds, default in kmph to 100.
Show arguments
unit • AccelerationUnit
Show AccelerationUnit enum values
seconds_to_100_kilometers_per_hour
Return the acceleration in seconds to 100 kilometers per hour
seconds_to_60_miles_per_hour
Return the acceleration in seconds to 60 miles per hour
top_speed • Float
Top speed of the vehicle, default in kmph.
Show arguments
unit • SpeedUnit
Show SpeedUnit enum values
kilometers_per_hour
Return the speed in kilometers per hour
miles_per_hour
Return the speed in miles per hour
range • VehicleRange
Range of the vehicle.
provider • Float
Index range, default in km.
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
provider_is_estimated • Boolean
Indicates if index range is estimated.
worst • VehicleRangeValue
Worst conditions are based on -10°C and use of heating.
highway • Float
Estimated value on the highway or express roads, default in km.
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
city • Float
Estimated value on the cities road, default in km.
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
combined • Float
Estimated combined value, default in km.
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
best • VehicleRangeValue
Best conditions are based on 23°C and no use of A/C.
highway • Float
Estimated value on the highway or express roads, default in km.
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
city • Float
Estimated value on the cities road, default in km.
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
combined • Float
Estimated combined value, default in km.
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
chargetrip_range • ChargetripRange
Chargetrip's custom real-world range provides a carefully calculated display range for all electric vehicle models based on our own research and driving data. CT range is based on the theoretical distance driven using only the electric engine. Vehicles that do not have a full electric drivetrain type ( all except Battery Electric Vehicles / BEV) therefore return relatively small ranges.
worst • Int
Range in kilometers. Worst conditions are based on -10°C and use of heating
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
best • Int
Range in kilometers. Best conditions are based on 23°C and no use of A/C
Show arguments
unit • DistanceUnit
Show DistanceUnit enum values
meter
Return the distance in meters
foot
Return the distance in feet
kilometer
Return the distance in kilometers
mile
Return the distance in miles
media • VehicleMedia
Media of the vehicle.
image • VehicleImage
Featured image of the vehicle from a 45-degree angle.
id • ID
Image id.
type • VehicleImageType
Image type.
Show VehicleImageType enum values
provider
Images provided by a Vehicle Datasource.
image
Full-sized image at 1536x864 px.
image_thumbnail
Thumbnail of a full-sized image at 131x72 px.
image_premium
Premium image.
premium_image_thumbnail
Thumbnail of a premium image.
brand
Full-sized brand (maker) logo at 768x432 px.
brand_thumbnail
Thumbnail of a full-sized brand logo at 56x24 px.
placeholder
Placeholder image at 1536x864 px.
url • String
Full path URL of a large image.
height • Int
Height of a large image in pixels.
width • Int
Width of a large image in pixels.
thumbnail_url • String
Full path URL of a thumbnail image.
thumbnail_height • Int
Height of a thumbnail image in pixels.
thumbnail_width • Int
Width of a thumbnail image in pixels.
brand • VehicleImage
Latest maker logo.
id • ID
Image id.
type • VehicleImageType
Image type.
Show VehicleImageType enum values
provider
Images provided by a Vehicle Datasource.
image
Full-sized image at 1536x864 px.
image_thumbnail
Thumbnail of a full-sized image at 131x72 px.
image_premium
Premium image.
premium_image_thumbnail
Thumbnail of a premium image.
brand
Full-sized brand (maker) logo at 768x432 px.
brand_thumbnail
Thumbnail of a full-sized brand logo at 56x24 px.
placeholder
Placeholder image at 1536x864 px.
url • String
Full path URL of a large image.
height • Int
Height of a large image in pixels.
width • Int
Width of a large image in pixels.
thumbnail_url • String
Full path URL of a thumbnail image.
thumbnail_height • Int
Height of a thumbnail image in pixels.
thumbnail_width • Int
Width of a thumbnail image in pixels.
image_list • VehicleImage
All images of the vehicle.
id • ID
Image id.
type • VehicleImageType
Image type.
Show VehicleImageType enum values
provider
Images provided by a Vehicle Datasource.
image
Full-sized image at 1536x864 px.
image_thumbnail
Thumbnail of a full-sized image at 131x72 px.
image_premium
Premium image.
premium_image_thumbnail
Thumbnail of a premium image.
brand
Full-sized brand (maker) logo at 768x432 px.
brand_thumbnail
Thumbnail of a full-sized brand logo at 56x24 px.
placeholder
Placeholder image at 1536x864 px.
url • String
Full path URL of a large image.
height • Int
Height of a large image in pixels.
width • Int
Width of a large image in pixels.
thumbnail_url • String
Full path URL of a thumbnail image.
thumbnail_height • Int
Height of a thumbnail image in pixels.
thumbnail_width • Int
Width of a thumbnail image in pixels.
video • VehicleVideo
Latest video.
id • ID
Video id.
url • String
Full path URL of a video.
video_list • VehicleVideo
All videos of the vehicle.
id • ID
Video id.
url • String
Full path URL of a video.
routing • VehicleRouting
Routing of the vehicle.
fast_charging_support • Boolean
Vehicles that support fast charging have a minimum charging speed of 43 kWh.
connect • Connect
Information about vehicle connectivity.
providers • ConnectProvider
List of connectivity providers to which the vehicle can connect. This field returns null for free users. Please contact customer success for more information.
Show ConnectProvider enum values
Enode
region • VehicleRegion
Regions in which the vehicle is available. Based on the continent code (CC) standard.
Show VehicleRegion enum values
AF
Africa.
AS
Asia.
EU
Europe.
NA
North America.
OC
Oceania.
SA
South America.
purpose • VehiclePurpose
Vehicle intended use. Can be passenger, cargo, or utility.
Show VehiclePurpose enum values
passenger
Vehicle intended for the transportation of passengers.
cargo
Vehicle intended for the transportation of cargo.
utility
Vehicle intended for the transportation of everything except cargo or passengers. Eg: ambulances, agricultural vehicles, etcetera.
type • VehicleType
Type of vehicle.
Show VehicleType enum values
motorcycle
Any motor vehicle with two wheels or a motor vehicle with no more than four wheels, does not have parallel seating, and is controlled by means of handlebars.
microcar
A motor vehicle with three or four wheels that is not a Motorcycle, Pickup, Van, Truck, or Utility vehicle and either has a top speed of less than 60kph or an unladen weight of less than 400kg.
car
A motor vehicle that does not have an enclosed cab, is not a microcar or utility vehicle, is capable of carrying eight or fewer people, and that has less than one third of its internal volume dedicated to cargo, living, or sleeping space in its default configuration.
pickup
A motor vehicle that has an enclosed cab, is not a utility vehicle, and has a fixed, non-articulated, open-top back cargo bed that is enclosed on at least three sides.
van
A motor vehicle that does not have an enclosed cab, is not a utility vehicle, that fulfills exactly one of the following conditions:
- It is capable of carrying more than eight but less than twenty people.
- At least one third of its internal volume is dedicated to cargo space in its default configuration.
- It is the passenger variant of a vehicle that meets criterion 2.
bus
A motor vehicle that does not have an enclosed cab, is not a Utility vehicle, and is capable of carrying 20 or more people in its default configuration.
truck
A motor vehicle that has an enclosed cab and is not a Pickup or Utility vehicle.
utility
A motor vehicle that fulfills at least one of the following conditions:
- It does not have wheels.
- It has some mode of locomotion other than wheels in its default configuration such as treads, skis, or floats.
- It is capable of air or water travel in its default configuration.
- It was manufactured primarily for some purpose other than transporting cargo or passengers.
- It does not conform to any of the criteria for the other vehicle categories.
Response
A response can either contain a data or an
errors object. The response header will always return
200 as a status code.
Data object
When successful, a data object will be returned with the
requested fields. If there are no fields present the
data object will return the operation name with the
appropriate return type. If the operation was a query, this output
will be an object of the schema’s query root type; if the operation
was a mutation, this output will be an object of the schema’s mutation
root type.
Error object
If unsuccessful, an errors object will be returned with
more details in the extensions object. The error object
can contain any of the following objects.
Error
VEHICLE_NOT_FOUND
No vehicle was found with the provided ID