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.

Filters

To filter your car list you can use the filter argument. You can use the filter: { connect: { providers: [Enode] } } to return all cars that can be connected through Enode.

To search your car list you can use the search argument to do a search over all naming fields. You can for example search on 'ID3' which will return all Volkswagen ID3 editions.

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

adapters list CarPlug

Adapters of connectors available for a car

battery object CarListBattery

Battery of a car

body object CarListBody

Body 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

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

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