Query premium vehicle details
Get access to even more detailed data through the vehiclePremium query. It contains extended data about the battery, the body of the vehicle, availability, pricing, efficiency, safety, and more. Contact sales to upgrade to premium vehicle data.
Query
A vehicle id is required to get vehicle premium details. Pull the id from the vehicleList query. Use the country argument to apply localization to the data. For example, set country to US to receive the names and plug types as they are known in the United States.
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
XK
YE
YT
ZA
ZM
ZW
Frequently used fields
id • ID
Vehicles unique ID.
naming • VehiclePremiumNaming
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 a version name, or uses the same version name across all trims or consecutive years.
length_version • String
Vehicle model length version.
height_version • String
Vehicle model height version.
connectors • VehicleConnector
Connectors available 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.
fast_charge • VehiclePremiumFastCharge
Fast charge details.
plug • VehiclePremiumChargePlug
Details about the connector.
value • ConnectorType
Type of charge port on vehicle.
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.
is_estimated • Boolean
Indicates if value is an estimate.
location • String
Location of charge port.
power • VehiclePremiumChargePower
Power during fast charging from 10% to 80% SoC (optimal conditions, fastest charger).
max • Float
Maximum value.
average • Float
Average value.
charge_time • Float
Minutes needed to charge from 10% to 80%, with average charging power (optimal conditions, fastest charger).
charge_speed • Float
Charging speed during fast charging from 10% to 80% (optimal conditions, fastest charger), default is kmph.
Show arguments
unit • ChargeSpeedUnit
Show ChargeSpeedUnit enum values
kilowatt_hour
Return the charge speed in kilowatt hours.
kilometers_per_hour
Return the charge speed in kilometers per hour.
miles_per_hour
Return the charge speed in miles per hour.
is_optional • Boolean
Indicates if fast charge is optional in some markets/regions.
is_estimated • Boolean
Indicates what fields are estimated.
table • VehiclePremiumFastChargeTable
Charging details for fast charging.
format • String
Charging details for fast charging (format: ChargerConnector-ChargerPower-AC/DC).
power • VehiclePremiumChargePower
Fast charge power.
max • Float
Maximum value.
average • Float
Average value.
charge_time • Int
Minutes needed to charge from 10% to 80% (optimal conditions).
charge_speed • Float
Charging speed during fast charging from 10% to 80% (optimal conditions), default is kmph.
Show arguments
unit • ChargeSpeedUnit
Show ChargeSpeedUnit enum values
kilowatt_hour
Return the charge speed in kilowatt hours.
kilometers_per_hour
Return the charge speed in kilometers per hour.
miles_per_hour
Return the charge speed in miles per hour.
is_limited • Boolean
Indicates if maximum power during fast charging is limited by the vehicle.
average_is_limited • Boolean
Indicates if average power during fast charging is limited by the vehicle.
has_autocharge • Boolean
Indicates if autocharge is available.
iso_15118_pnc_support • VehiclePlugAndChargeSupport
Status of Plug & Charge (PnC ISO15118) support for vehicle.
Show VehiclePlugAndChargeSupport enum values
available
Plug and charge is available.
announced
Plug and charge is announced, but not yet available.
limited
Plug and charge is available in a limited context.
not_available
Plug and charge is not available.
iso_15118_pnc_support_2 • VehiclePlugAndChargeSupport
Status of Plug & Charge (PnC ISO15118) -2 protocol support for vehicle.
Show VehiclePlugAndChargeSupport enum values
available
Plug and charge is available.
announced
Plug and charge is announced, but not yet available.
limited
Plug and charge is available in a limited context.
not_available
Plug and charge is not available.
iso_15118_pnc_support_20 • VehiclePlugAndChargeSupport
Status of Plug & Charge (PnC ISO15118) -20 protocol support for vehicle.
Show VehiclePlugAndChargeSupport enum values
available
Plug and charge is available.
announced
Plug and charge is announced, but not yet available.
limited
Plug and charge is available in a limited context.
not_available
Plug and charge is not available.
is_fastned_tested • Boolean
Indicates if the fastcharge data is based on a real-world test by Fastned.
routing • VehiclePremiumRouting
Routing of the vehicle.
fast_charging_support • Boolean
Vehicles that support fast charging have a minimum charging speed of 43 kWh.
drag_coefficient • Float
Drag coefficient.
tire_pressure • Float
Tire pressure recommended by manufacturer, default in bar.
Show arguments
unit • PressureUnit
Show PressureUnit enum values
bar
Return the pressure in bar.
pounds_per_square_inch
Return the pressure in pounds per square inch.
consumption • VehiclePremiumRoutingConsumption
Extra consumption model.
auxiliary • Float
The amount of energy, in kWh, used by the auxiliary systems of the vehicle in a hour, like media box, etc
aux • VehiclePremiumRoutingConsumptionValue
Deprecated
Consumption, in kWh, of the auxiliaries.
best • Float
Best (lowest) consumption in summer.
worst • Float
Best (lowest) consumption in winter.
bms • VehiclePremiumRoutingConsumptionValue
Deprecated
Consumption, in kWh, of the battery management system.
best • Float
Best (lowest) consumption in summer.
worst • Float
Best (lowest) consumption in winter.
idle • VehiclePremiumRoutingConsumptionValue
Deprecated
Consumption, in kWh, of the vehicle in idle mode.
best • Float
Best (lowest) consumption in summer.
worst • Float
Best (lowest) consumption in winter.
fuel_consumption • Float
Amount of petrol that an equivalent petrol vehicle would consume, default in l/100 km.
Show arguments
unit • FuelConsumptionUnit
Show FuelConsumptionUnit enum values
liters_per_100_kilometers
Return the fuel consumption in liters per 100 kilometers.
miles_per_gallon
Return the fuel consumption in miles per gallon.
Other fields
succesor_id • String
Internal ID of the successor vehicle trim.
charge • VehiclePremiumCharge
Charge details.
plug • VehiclePremiumChargePlug
Information about the main connector.
value • ConnectorType
Type of charge port on vehicle.
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.
is_estimated • Boolean
Indicates if value is an estimate.
location • String
Location of charge port.
second_plug • VehiclePremiumChargeSecondPlug
Information about vehicles secondary onboard charger.
location • String
Location of charge port.
is_optional • Boolean
Indicates if second charge port is optional.
standard • VehiclePremiumChargeStandardOBC
Information about the vehicle standard onboard charger.
power • Float
Maximum power OBC can accept to charge a battery (standard OBC).
phases • Int
Number of phases the OBC accepts to achieve maximum power (standard OBC).
phase_amperage • Float
Maximum current the OBC accepts per phase to achieve maximum power (standard OBC).
charge_time • Int
Minutes needed to charge from 0% to 100% (standard OBC).
charge_speed • Float
Charging speed when charging at maximum power (standard OBC), default in kmph.
Show arguments
unit • ChargeSpeedUnit
Show ChargeSpeedUnit enum values
kilowatt_hour
Return the charge speed in kilowatt hours.
kilometers_per_hour
Return the charge speed in kilometers per hour.
miles_per_hour
Return the charge speed in miles per hour.
is_estimated • Boolean
Indicates if Charge_Standard fields are estimated.
table • VehiclePremiumChargeOBCTable
Charging details for the standard OBC at several charging points.
evse_phase_voltage • Int
Voltage between phase and neutral for this EVSE (phase voltage).
evse_phase_amperage • Int
Current per phase for this EVSE (phase current).
evse_phases • Int
Number of phases for this EVSE.
charge_phase_voltage • Int
Voltage between phase and neutral used by standard OBC (phase voltage).
charge_phase_amperage • Float
Current per phase used by standard OBC (phase current).
charge_phases • Int
Number of phases used by standard OBC.
charge_power • Float
Power used by standard OBC (before OBC losses).
charge_time • Int
Minutes needed to charge from 0% to 100% (standard OBC with this EVSE).
charge_speed • Float
Charging speed when charging at maximum power (standard OBC with this EVSE), default in kmph.
Show arguments
unit • ChargeSpeedUnit
Show ChargeSpeedUnit enum values
kilowatt_hour
Return the charge speed in kilowatt hours.
kilometers_per_hour
Return the charge speed in kilometers per hour.
miles_per_hour
Return the charge speed in miles per hour.
option • VehiclePremiumChargeOptionOBC
Optional upgrade for the standard onboard charger when available.
power • Float
Maximum power OBC can accept to charge a battery (standard OBC).
phases • Int
Number of phases the OBC accepts to achieve maximum power (standard OBC).
phase_amperage • Float
Maximum current the OBC accepts per phase to achieve maximum power (standard OBC).
charge_time • Int
Minutes needed to charge from 0% to 100% (standard OBC).
charge_speed • Float
Charging speed when charging at maximum power (standard OBC), default in kmph.
Show arguments
unit • ChargeSpeedUnit
Show ChargeSpeedUnit enum values
kilowatt_hour
Return the charge speed in kilowatt hours.
kilometers_per_hour
Return the charge speed in kilometers per hour.
miles_per_hour
Return the charge speed in miles per hour.
table • VehiclePremiumChargeOBCTable
Charging details for the standard OBC at several charging points.
evse_phase_voltage • Int
Voltage between phase and neutral for this EVSE (phase voltage).
evse_phase_amperage • Int
Current per phase for this EVSE (phase current).
evse_phases • Int
Number of phases for this EVSE.
charge_phase_voltage • Int
Voltage between phase and neutral used by standard OBC (phase voltage).
charge_phase_amperage • Float
Current per phase used by standard OBC (phase current).
charge_phases • Int
Number of phases used by standard OBC.
charge_power • Float
Power used by standard OBC (before OBC losses).
charge_time • Int
Minutes needed to charge from 0% to 100% (standard OBC with this EVSE).
charge_speed • Float
Charging speed when charging at maximum power (standard OBC with this EVSE), default in kmph.
Show arguments
unit • ChargeSpeedUnit
Show ChargeSpeedUnit enum values
kilowatt_hour
Return the charge speed in kilowatt hours.
kilometers_per_hour
Return the charge speed in kilometers per hour.
miles_per_hour
Return the charge speed in miles per hour.
alternative • VehiclePremiumChargeAlternativeOBC
Alternative upgrade for the standard onboard charger when available.
power • Float
Maximum power OBC can accept to charge a battery (standard OBC).
phases • Int
Number of phases the OBC accepts to achieve maximum power (standard OBC).
phase_amperage • Float
Maximum current the OBC accepts per phase to achieve maximum power (standard OBC).
charge_time • Int
Minutes needed to charge from 0% to 100% (standard OBC).
charge_speed • Float
Charging speed when charging at maximum power (standard OBC), default in kmph.
Show arguments
unit • ChargeSpeedUnit
Show ChargeSpeedUnit enum values
kilowatt_hour
Return the charge speed in kilowatt hours.
kilometers_per_hour
Return the charge speed in kilometers per hour.
miles_per_hour
Return the charge speed in miles per hour.
table • VehiclePremiumChargeOBCTable
Charging details for the standard OBC at several charging points.
evse_phase_voltage • Int
Voltage between phase and neutral for this EVSE (phase voltage).
evse_phase_amperage • Int
Current per phase for this EVSE (phase current).
evse_phases • Int
Number of phases for this EVSE.
charge_phase_voltage • Int
Voltage between phase and neutral used by standard OBC (phase voltage).
charge_phase_amperage • Float
Current per phase used by standard OBC (phase current).
charge_phases • Int
Number of phases used by standard OBC.
charge_power • Float
Power used by standard OBC (before OBC losses).
charge_time • Int
Minutes needed to charge from 0% to 100% (standard OBC with this EVSE).
charge_speed • Float
Charging speed when charging at maximum power (standard OBC with this EVSE), default in kmph.
Show arguments
unit • ChargeSpeedUnit
Show ChargeSpeedUnit enum values
kilowatt_hour
Return the charge speed in kilowatt hours.
kilometers_per_hour
Return the charge speed in kilometers per hour.
miles_per_hour
Return the charge speed in miles per hour.
vehicle_to_everything • VehicleToEverything
Vehicle-to-everything charge support.
vehicle_to_load • VehicleToEverythingLoad
Information about Vehicle-to-Load.
ac • VehicleToEverythingPower
Vehicle-to-Load power information.
is_supported • PowerSupported
Indicates if this charging is supported.
Show PowerSupported enum values
available
Power is supported.
not_available
Power is not supported.
announced
Power is announced, but not yet supported.
maximum_power • String
Maximum power output, in kilowatts.
interior_ports • String
Details on interior ports available for V2L.
exterior_ports • String
Details on exterior ports available for V2L.
vehicle_to_home • VehicleToEverythingHomeGrid
Information about Vehicle-to-Home.
ac • VehicleToEverythingPower
Vehicle-to-Home/Grid AC power information.
is_supported • PowerSupported
Indicates if this charging is supported.
Show PowerSupported enum values
available
Power is supported.
not_available
Power is not supported.
announced
Power is announced, but not yet supported.
maximum_power • String
Maximum power output, in kilowatts.
dc • VehicleToEverythingPower
Vehicle-to-Home/Grid DC power information
is_supported • PowerSupported
Indicates if this charging is supported.
Show PowerSupported enum values
available
Power is supported.
not_available
Power is not supported.
announced
Power is announced, but not yet supported.
maximum_power • String
Maximum power output, in kilowatts.
vehicle_to_grid • VehicleToEverythingHomeGrid
Information about Vehicle-to-Grid.
ac • VehicleToEverythingPower
Vehicle-to-Home/Grid AC power information.
is_supported • PowerSupported
Indicates if this charging is supported.
Show PowerSupported enum values
available
Power is supported.
not_available
Power is not supported.
announced
Power is announced, but not yet supported.
maximum_power • String
Maximum power output, in kilowatts.
dc • VehicleToEverythingPower
Vehicle-to-Home/Grid DC power information
is_supported • PowerSupported
Indicates if this charging is supported.
Show PowerSupported enum values
available
Power is supported.
not_available
Power is not supported.
announced
Power is announced, but not yet supported.
maximum_power • String
Maximum power output, in kilowatts.
adapters • VehicleConnector
Adapters of connectors available for a 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 • VehiclePremiumBattery
Battery of the vehicle.
usable_kwh • Float
Usable battery capacity in kWh.
full_kwh • Float
Full battery capacity in kWh.
estimated_fields • VehicleBatteryFieldEstimations
Indicates which battery fields are estimated.
Show VehicleBatteryFieldEstimations enum values
B
Both of the battery kWh fields are estimations.
F
full_kwh field is estimated.
N
None of the battery kWh fields are estimations.
U
usable_kwh field is estimated.
thermal_management_system • String
Battery thermal management system (active/passive, air/liquid).
warranty_period • Float
Duration of battery warranty.
warranty_mileage • Float
Mileage of battery warranty.
chemistry • String
Chemistry of the battery.
manufacturer • String
Manufacturer of the battery.
modules • Float
Number of battery modules.
cells • String
Number of cells in the battery pack, can include configuration (s = serial, p = parallel).
weight • Float
Weight of the battery pack.
nominal_voltage • Float
Nominal voltage of battery.
type • VehicleBatteryType
Type of battery.
Show VehicleBatteryType enum values
lithium_ion
Lithium-Ion Battery.
body • VehiclePremiumBody
Body of the vehicle.
length • Float
Length, default in mm.
Show arguments
unit • MeasurementUnit
Show MeasurementUnit enum values
millimeter
Return the measurement in millimeters.
inch
Return the measurement in inches.
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.
full_width • Float
Width of vehicle including 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.
size_is_estimated • Boolean
Indicates if length/width/height fields are estimations.
wheelbase • Float
Wheelbase, default in mm.
Show arguments
unit • MeasurementUnit
Show MeasurementUnit enum values
millimeter
Return the measurement in millimeters.
inch
Return the measurement in inches.
wheelbase_is_estimated • Boolean
Indicates if wheelbase field is estimated.
ground_clearance • Float
Ground clearance of a vehicle as specified by the OEM, 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 EU).
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.
weight_gvwr • VehicleBodyWeight
Maximum allowed vehicle weight with payload.
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.
weight_gtw • VehicleBodyWeight
Maximum allowed vehicle and trailer weight with payload.
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.
weight_payload • VehicleBodyWeight
Allowed payload weight.
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.
weight_is_estimated • Boolean
Indicates if weight field is estimated.
weight_max_payload • Float
Maximum payload allowed for the vehicle, default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms.
pound
Return the weight in pounds.
max_gross_vehicle_weight • Float
Deprecated
Gross Vehicle Weight (GVWR) - (max allowed vehicle weight with payload), default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms.
pound
Return the weight in pounds.
boot_capacity • Float
Standard luggage capacity, default in l.
Show arguments
unit • VolumeUnit
Show VolumeUnit enum values
liter
Return the volume in liters.
cubic_meter
Return the volume in cubic meters.
cubic_foot
Return the volume in cubic feet.
boot_front_capacity • Float
Storage capacity of front trunk/under the hood (frunk), default in l.
boot_capacity_max • Float
Maximum luggage capacity, default in l.
Show arguments
unit • VolumeUnit
Show VolumeUnit enum values
liter
Return the volume in liters.
cubic_meter
Return the volume in cubic meters.
cubic_foot
Return the volume in cubic feet.
tow_hitch_compatible • Boolean
Indicates if a tow hitch/towbar can be fitted according to vehicle homologation.
tow_weight_unbraked • Float
Maximum unbraked towing weight, default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms.
pound
Return the weight in pounds.
tow_weight_braked • Float
Maximum braked towing weight, default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms.
pound
Return the weight in pounds.
tow_weight_is_estimated • Boolean
Indicates if tow weight fields are estimations.
tow_weight_vertical_load • Float
Maximum vertical load / noseweight on tow hitch according to vehicle homologation, default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms.
pound
Return the weight in pounds.
roof_load_max • Float
Maximum load on roof of the vehicle, default in kg.
Show arguments
unit • WeightUnit
Show WeightUnit enum values
kilogram
Return the weight in kilograms.
pound
Return the weight in pounds.
body_type • String
Body type, listed in local naming convention where applicable.
segment • String
Segment, listed in local naming convention where applicable.
seats • Int
Number of seats.
has_roofrails • Boolean
Indicates whether a vehicle has roof rails as a standard.
turning_circle • Float
Turning circle of the vehicle kerb-to-kerb, default in meters.
Show arguments
unit • TurningCircleUnit
Show TurningCircleUnit enum values
meter
Return the turning circle in meters.
foot
Return the turning circle in feet.
vehicle_platform • String
Name of the vehicle platform used for vehicle (often abbreviated to indicate group platforms).
vehicle_platform_is_dedicated • Boolean
Indicates if the vehicle platform used for vehicle is a dedicated battery electric vehicle platform.
availability • VehiclePremiumAvailability
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.
date_from • String
Date of introduction, mm-yyyy.
date_from_is_estimated • Boolean
Indicates if date from field is estimated.
date_to • String
Date last available, mm-yyyy.
price • VehiclePremiumPrice
Deprecated
Pricing of the vehicle.
DE • VehiclePremiumPriceValueWithGrant
Starting price for German market.
value • Float
Starting price for local market expressed in the currency in the field currency.
Show arguments
unit • CurrencyUnit
Show CurrencyUnit enum values
EUR
Return the currency in EUR.
USD
Return the currency in USD.
GBP
Return the currency in GBP.
currency • CurrencyUnit
Currency in which the value without optional field conversion is expressed.
Show CurrencyUnit enum values
EUR
Return the currency in EUR.
USD
Return the currency in USD.
GBP
Return the currency in GBP.
is_estimated • Boolean
Indicates if the starting price is based on an estimate.
grant_applied • Int
Grant that is applied to the starting price.
price_delivery • Int
Total delivery fees (be aware that this field does not include grant).
price_first_registration_fee • Int
First registration fee (be aware that this field does not include grant).
NL • VehiclePremiumPriceValueWithGrant
Starting price for Dutch market.
value • Float
Starting price for local market expressed in the currency in the field currency.
Show arguments
unit • CurrencyUnit
Show CurrencyUnit enum values
EUR
Return the currency in EUR.
USD
Return the currency in USD.
GBP
Return the currency in GBP.
currency • CurrencyUnit
Currency in which the value without optional field conversion is expressed.
Show CurrencyUnit enum values
EUR
Return the currency in EUR.
USD
Return the currency in USD.
GBP
Return the currency in GBP.
is_estimated • Boolean
Indicates if the starting price is based on an estimate.
grant_applied • Int
Grant that is applied to the starting price.
price_delivery • Int
Total delivery fees (be aware that this field does not include grant).
price_first_registration_fee • Int
First registration fee (be aware that this field does not include grant).
GB • VehiclePremiumPriceValueWithGrant
Starting price for British market.
value • Float
Starting price for local market expressed in the currency in the field currency.
Show arguments
unit • CurrencyUnit
Show CurrencyUnit enum values
EUR
Return the currency in EUR.
USD
Return the currency in USD.
GBP
Return the currency in GBP.
currency • CurrencyUnit
Currency in which the value without optional field conversion is expressed.
Show CurrencyUnit enum values
EUR
Return the currency in EUR.
USD
Return the currency in USD.
GBP
Return the currency in GBP.
is_estimated • Boolean
Indicates if the starting price is based on an estimate.
grant_applied • Int
Grant that is applied to the starting price.
price_delivery • Int
Total delivery fees (be aware that this field does not include grant).
price_first_registration_fee • Int
First registration fee (be aware that this field does not include grant).
pricing • VehiclePremiumPriceValueWithGrant
Starting price in the currency defined in the field argument. If not defined, it will return the starting price in the currency returned in the currency field.
value • Float
Starting price for local market expressed in the currency in the field currency.
Show arguments
unit • CurrencyUnit
Show CurrencyUnit enum values
EUR
Return the currency in EUR.
USD
Return the currency in USD.
GBP
Return the currency in GBP.
currency • CurrencyUnit
Currency in which the value without optional field conversion is expressed.
Show CurrencyUnit enum values
EUR
Return the currency in EUR.
USD
Return the currency in USD.
GBP
Return the currency in GBP.
is_estimated • Boolean
Indicates if the starting price is based on an estimate.
grant_applied • Int
Grant that is applied to the starting price.
price_delivery • Int
Total delivery fees (be aware that this field does not include grant).
price_first_registration_fee • Int
First registration fee (be aware that this field does not include grant).
drivetrain • VehiclePremiumDrivetrain
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.
fuel • VehicleFuel
Fuel type.
Show VehicleFuel enum values
D
ICE engine available. Uses diesel.
E
Electricity only. Full electric vehicle.
P
ICE engine available. Uses petrol.
propulsion • VehiclePropulsion
Propulsion type.
Show VehiclePropulsion enum values
AWD
All-wheel drive vehicle.
Front
Front-wheel drive vehicle.
Rear
Rear-wheel drive vehicle.
propulsion_is_estimated • Boolean
Indicates if propulsion field is estimated.
power • Float
Maximum (combined) power output, default in kw.
Show arguments
unit • PowerUnit
Show PowerUnit enum values
kilowatt
Return the power in kilowatts.
horsepower
Return the power in horsepower.
power_is_estimated • Boolean
Indicates if power field is estimated.
power_hp • Float
Maximum (combine) power output, default in horsepower (PS).
Show arguments
unit • PowerUnit
Show PowerUnit enum values
kilowatt
Return the power in kilowatts.
horsepower
Return the power in horsepower.
torque • Float
Maximum (combine) torque output, default in newton meter.
Show arguments
unit • TorqueUnit
Show TorqueUnit enum values
newton_meter
Return the torque in newton meters.
foot_pound
Return the torque in foot pounds.
torque_is_estimated • Boolean
Indicates if torque field is estimated.
performance • VehiclePremiumPerformance
Performance of the vehicle.
acceleration • Float
Acceleration 0-100 km/h, default in seconds.
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.
acceleration_is_estimated • Boolean
Indicates if acceleration field is estimated.
top_speed • Float
Top speed of the vehicle, default in km/h.
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.
top_speed_is_estimated • Boolean
Indicates if top_speed field is estimated.
range • VehiclePremiumRange
Range of the vehicle.
wltp • Float
Rated range in WLTP combined cycle (NULL if not WLTP rated), default in km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
wltp_is_estimated • Boolean
Indicates if WLTP range is estimated (NULL if not WLTP rated).
wltp_teh • Int
Rated range in WLTP (TEH/least efficient trim) combined cycle (NULL if not WLTP rated).
nedc • Float
Rated range in NEDC combined cycle (NULL if not NEDC rated), default in km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
nedc_is_estimated • Boolean
Indicates if NEDC range is estimated (NULL if not NEDC rated).
provider • Float
Index range, default in km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
provider_is_estimated • Boolean
Indicates if index range is estimated.
worst • VehiclePremiumRangeValue
Worst conditions are based on -10°C and use of heating.
highway • Float
Estimated value on 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 city 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.
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 • VehiclePremiumRangeValue
Best conditions are based on 23°C and no use of A/C.
highway • Float
Estimated value on 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 city 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.
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. Chargetrip 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. More information on the CT range can be found at https://chargetrip.com/blog/what-is-ct-real-range
worst • Int
Range calculated using the worst conditions. Worst conditions are based on -0°C, including use of heating. More information on the CT range can be found at https://chargetrip.com/blog/what-is-ct-real-range
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 calculated using the best conditions. Best conditions are based on 25°C, including use of A/C. More information on the CT range can be found at https://chargetrip.com/blog/what-is-ct-real-range
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.
efficiency • VehiclePremiumEfficiency
Efficiency of the vehicle.
wltp • VehiclePremiumEfficiencyWLTP
Rated efficiency in WLTP combined cycle.
value • Float
Rated efficiency in WLTP combined cycle, default in kWh/100 km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
fuel_equivalent • Float
Rated efficiency in WLTP combined cycle presented in gas equivalent, default in l/100 km.
Show arguments
unit • FuelConsumptionUnit
Show FuelConsumptionUnit enum values
liters_per_100_kilometers
Return the fuel consumption in liters per 100 kilometers.
miles_per_gallon
Return the fuel consumption in miles per gallon.
vehicle • Float
Rated vehicle efficiency in WLTP combined cycle (based on value), default in kWh/100 km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
vehicle_fuel_equivalent • Float
Rated vehicle efficiency in WLTP combined cycle presented in gas equivalent, default in l/100 km.
Show arguments
unit • FuelConsumptionUnit
Show FuelConsumptionUnit enum values
liters_per_100_kilometers
Return the fuel consumption in liters per 100 kilometers.
miles_per_gallon
Return the fuel consumption in miles per gallon.
co2 • Float
Rated CO2 emissions in WLTP combined cycle in battery-only mode (NULL if not WLTP rated), default in gr/km.
Show arguments
unit • EmissionRateUnit
Show EmissionRateUnit enum values
grams_per_kilometer
Return the emission rate in grams per kilometer.
ounces_per_mile
Return the emission rate in ounces per mile.
wltp_teh • VehiclePremiumEfficiencyWLTPTEH
Rated efficiency in WLTP combined cycle (TEH / least efficient trim).
value • Float
Rated efficiency in WLTP TEH combined cycle (TEH/least efficient trim).
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
fuel_equivalent • Float
Rated efficiency in WLTP TEH combined cycle presented in gas equivalent, default in l/100 km.
Show arguments
unit • FuelConsumptionUnit
Show FuelConsumptionUnit enum values
liters_per_100_kilometers
Return the fuel consumption in liters per 100 kilometers.
miles_per_gallon
Return the fuel consumption in miles per gallon.
vehicle • Float
Rated vehicle efficiency in WLTP TEH combined cycle (based on value), default in kWh/100 km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
vehicle_fuel_equivalent • Float
Rated vehicle efficiency in WLTP TEH combined cycle presented in gas equivalent, default in l/100 km.
Show arguments
unit • FuelConsumptionUnit
Show FuelConsumptionUnit enum values
liters_per_100_kilometers
Return the fuel consumption in liters per 100 kilometers.
miles_per_gallon
Return the fuel consumption in miles per gallon.
co2 • Float
Rated CO2 emissions in WLTP TEH combined cycle in battery-only mode (NULL if not WLTP TEH rated), default in gr/km.
Show arguments
unit • EmissionRateUnit
Show EmissionRateUnit enum values
grams_per_kilometer
Return the emission rate in grams per kilometer.
ounces_per_mile
Return the emission rate in ounces per mile.
nedc • VehiclePremiumEfficiencyNEDC
Rated efficiency in NEDC combined cycle.
value • Float
Rated efficiency in NEDC combined cycle, default in kWh/100 km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
fuel_equivalent • Float
Rated efficiency in NEDC combined cycle presented in gas equivalent, default in l/100 km.
Show arguments
unit • FuelConsumptionUnit
Show FuelConsumptionUnit enum values
liters_per_100_kilometers
Return the fuel consumption in liters per 100 kilometers.
miles_per_gallon
Return the fuel consumption in miles per gallon.
vehicle • Float
Rated vehicle efficiency in NEDC combined cycle (based on value), default in kWh/100 km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
vehicle_fuel_equivalent • Float
Rated vehicle efficiency in NEDC combined cycle presented in gas equivalent, default in l/100 km.
Show arguments
unit • FuelConsumptionUnit
Show FuelConsumptionUnit enum values
liters_per_100_kilometers
Return the fuel consumption in liters per 100 kilometers.
miles_per_gallon
Return the fuel consumption in miles per gallon.
co2 • Float
Rated CO2 emissions in NEDC combined cycle in battery-only mode (NULL if not NEDC rated), default in gr/km.
Show arguments
unit • EmissionRateUnit
Show EmissionRateUnit enum values
grams_per_kilometer
Return the emission rate in grams per kilometer.
ounces_per_mile
Return the emission rate in ounces per mile.
provider • VehiclePremiumEfficiencyProvider
Vehicle efficiency based on provider range.
value • Float
Vehicle efficiency based on RealRange (usable battery/range), default in kWh/100 km.
Show arguments
unit • ConsumptionUnit
Show ConsumptionUnit enum values
kilowatt_hours_per_100_kilometers
Return the consumption in kilowatt hours per 100 kilometers.
watt_hours_per_kilometer
Return the consumption in watt hours per kilometer.
kilometers_per_kilowatt_hour
Return the consumption in kilometers per kilowatt hour.
kilowatt_hours_per_100_miles
Return the consumption in kilowatt hours per 100 miles.
watt_hours_per_mile
Return the consumption in watt hours per mile.
miles_per_kilowatt_hour
Return the consumption in miles per kilowatt hour.
fuel_equivalent • Float
Vehicle efficiency based on RealRange presented in gas equivalent, default in l/100 km.
Show arguments
unit • FuelConsumptionUnit
Show FuelConsumptionUnit enum values
liters_per_100_kilometers
Return the fuel consumption in liters per 100 kilometers.
miles_per_gallon
Return the fuel consumption in miles per gallon.
worst • VehiclePremiumEfficiencyProviderValue
Worst conditions are based on -10°C and use of heating.
highway • Float
Estimated value on 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 city 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.
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 • VehiclePremiumEfficiencyProviderValue
Best conditions are based on 23°C and no use of A/C.
highway • Float
Estimated value on 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 city 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.
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.
safety • VehiclePremiumSafety
Safety of the vehicle.
isofix_seats • Int
Number of seats equipped with ISOFIX.
euro_ncap • VehiclePremiumSafetyEuroNcap
EuroNCAP results.
rating • Int
EuroNCAP rating (out of 5 stars).
year • Int
EuroNCAP year of rating.
adult • Int
EuroNCAP rating of adult protection (out of 100%).
child • Int
EuroNCAP rating of child protection (out of 100%).
vru • Int
EuroNCAP rating of vulnerable road users (out of 100%).
sa • Int
EuroNCAP rating of safety assists (out of 100%).
url • String
Link to the EuroNCAP test report.
media • VehiclePremiumMedia
Media of the vehicle.
provider_details_url • String
URL for more details.
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 (make) logo at 768x432 px.
brand_thumbnail
Thumbnail of a full-sized brand (make) 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
Deprecated
Latest make 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 (make) logo at 768x432 px.
brand_thumbnail
Thumbnail of a full-sized brand (make) 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.
make • VehicleImage
Latest make 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 (make) logo at 768x432 px.
brand_thumbnail
Thumbnail of a full-sized brand (make) 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 (make) logo at 768x432 px.
brand_thumbnail
Thumbnail of a full-sized brand (make) 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.
oem_details_url • String
URL of the OEM page for this vehicle.
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.
heat_pump • VehicleHeatPump
Details about Heat Pump.
is_available • Boolean
Indicates if a heat pump is available for a specific vehicle.
is_standard_equipment • Boolean
Indicates if a heat pump is standard equipment for a specific vehicle.
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
Error
VEHICLE_PREMIUM_NOT_ALLOWED
You are not allowed to query for premium vehicle data. Please contact the support team to enable this feature!