Query vehicle details
Vehicle data can be useful when you want to display more information about the vehicle. You can access data using the vehicle
query or get even more data with vehiclePremium
. 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 your vehicles.
Query
To get specific details of a vehicle you need 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 EV models. This is based on our own research and driving data
worst • Float
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 • Float
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
Latest image
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
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
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
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
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
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 a vehicle can connect
Show ConnectProvider enum values
Enode
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.
VEHICLE_NOT_FOUND
No vehicle was found with the provided ID