Arguments

id· ID· required
Vehicles unique ID.
country· CountryCodeAlpha2
ISO-3166 alpha-2 country code to apply localization on vehicle data if available.
AA

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

Fields

id· ID
Vehicles unique ID.
succesor_id· String
Internal ID of the successor vehicle trim.
naming· VehiclePremiumNaming
Naming of the vehicle.
connectors· VehicleConnector
Connectors available for the vehicle. Please note that for HEVs this will always be an empty array.
charge· VehiclePremiumCharge
Charge details.
fast_charge· VehiclePremiumFastCharge
Fast charge details.
adapters· VehicleConnector
Adapters of connectors available for a connectors of the vehicle. Please note that for HEVs this will always be an empty array.
battery· VehiclePremiumBattery
Battery of the vehicle.
body· VehiclePremiumBody
Body of the vehicle.
availability· VehiclePremiumAvailability
Availability of the vehicle.
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.
drivetrain· VehiclePremiumDrivetrain
Drivetrain of the vehicle.
performance· VehiclePremiumPerformance
Performance of the vehicle.
range· VehiclePremiumRange
Range of the vehicle.
efficiency· VehiclePremiumEfficiency
Efficiency of the vehicle.
safety· VehiclePremiumSafety
Safety of the vehicle.
media· VehiclePremiumMedia
Media of the vehicle.
routing· VehiclePremiumRouting
Routing of the vehicle.
connect· Connect
Information about vehicle connectivity.
region· VehicleRegion
Regions in which the vehicle is available. Based on the continent code (CC) standard.
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.
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.
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: 1) It is capable of carrying more than eight but less than twenty people. 2) At least one third of its internal volume is dedicated to cargo space in its default configuration. 3) 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: 1) It does not have wheels. 2) It has some mode of locomotion other than wheels in its default configuration such as treads, skis, or floats. 3) It is capable of air or water travel in its default configuration. 4) It was manufactured primarily for some purpose other than transporting cargo or passengers. 5) It does not conform to any of the criteria for the other vehicle categories.

heat_pump· VehicleHeatPump
Details about Heat Pump.

Exceptions

Codes

operation_not_allowed
You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
rate_limit_exceeded
Rate limit exceeded.
vehicle_not_found
No vehicle was found with the provided ID.
vehicle_premium_not_allowed
You are not allowed to query for premium vehicle data. Please contact the support team to enable this feature!
  • Getting started

    Get started with the Chargetrip API.

  • API reference

    Browse our api and endpoints.

  • Examples

    Explore examples and start building.

How filter works

The filter argument lets you narrow down results by passing an input object with specific criteria. Each field within the filter is optional — only include the ones relevant to your query.