Query cars

In order to see all cars in our car database you can use the carList query. To create fast front-ends, you are allowed to cache the carList query response. We recommend you query the carList at least once a day, never to miss an update. You can see a live example of this query including all available output parameters here.

Query car list

An example that renders a list of cars that can be searched and filtered.

Query car list

Query

To query the cars in your database, you only need to call the carList alongside the paramaters you would like to receive. Optionally you can add pagination and filters.

Filter

To filter your car list you can use the query argument. You can use the make to filter on a specific make, Tesla for example. Or filter on size, to specify the amount of cars you would like to receive. The default is 10.

Arguments

query input_object CarListQuery

Deprecated

Deprecated: Not used anymore

filter input_object CarListFilter

Filter car result

size scalar Int

Number of elements (count) to return, default: 10

page scalar Int

Page number to return, default: 0

Frequently used fields

id scalar ID

Cars unique ID

naming object CarListNaming

Naming of a car

connectors list CarPlug

Connectors available for a car

availability object CarListAvailability

Availability of a car

Other fields

id scalar ID

Cars unique ID

naming object CarListNaming

Naming of a car

connectors list CarPlug

Connectors available for a car

adapters list CarPlug

Adapters of connectors available for a car

battery object CarListBattery

Battery of a car

body object CarListBody

Body of a car

availability object CarListAvailability

Availability of a car

range object CarListRange

Range of a car

media object CarListMedia

Media of a car

routing object CarListRouting

Routing of a car

connect object Connect

Information about vehicle connectivity

externalId scalar String

Deprecated

ID provided by a car data source as the row ID

make scalar String

Deprecated

Car manufacturer

carModel scalar String

Deprecated

Car model

edition scalar String

Deprecated

Car edition

chargetripEdition scalar String

Deprecated

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

version scalar String

Deprecated

Car version

chargetripRange object ChargetripRange

Deprecated

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

fastChargingSupport scalar Boolean

Deprecated

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

mode enum CarMode

Deprecated

Current production mode of a car

seats scalar Int

Deprecated

Number of seats

batteryUsableKwh scalar Float

Deprecated

Usable battery capacity in kWh

batteryFullKwh scalar Float

Deprecated

Full battery capacity in kWh

imagesData object CarImageData

Deprecated

Images of a car in structured data

power scalar Float

Deprecated

acceleration scalar Float

Deprecated

topSpeed scalar Float

Deprecated

torque scalar Float

Deprecated

batteryEfficiency object CarBatteryEfficiency

Deprecated

weight scalar Float

Deprecated

height scalar Int

Deprecated

width scalar Int

Deprecated

consumption object CarExtraConsumption

Deprecated

petrolConsumption scalar Float

Deprecated

chargingOffset scalar JSON

Deprecated

auxConsumption scalar Float

Deprecated

bmsConsumption scalar Float

Deprecated

dragCoefficient scalar Float

Deprecated

tirePressure scalar Float

Deprecated

motorEfficiency scalar Float

Deprecated

drivelineEfficiency scalar Float

Deprecated

regenEfficiency scalar Float

Deprecated

images list CarImage

Deprecated

Response

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

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

Errors and warnings

Error

ERROR_FORBIDDEN_MESSAGE

You are forbidden to execute this operation

Error

PAGINATION_INVALID_PAGE

Page must be an INT value higher than 0

Error

PAGINATION_INVALID_SIZE

Size must be an INT value between 1 and 1000