Querying 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
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 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
Deprecated: Not used anymore
Search for cars by make, model, version and chargetrip version
Filter car result
Number of elements (count) to return, default: 10
Page number to return, default: 0
Frequently used fields
Cars unique ID
Naming of a car
Connectors available for a car
Availability of a car
Other fields
Adapters of connectors available for a car
Battery of a car
Body of a car
Range of a car
Media of a car
Routing of a car
Information about vehicle connectivity
ID provided by a car data source as the row ID
Car manufacturer
Car model
Car edition
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
Car version
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
Cars that support fast charging have a minimum charging speed of 43 kWh
Current production mode of a car
Number of seats
Usable battery capacity in kWh
Full battery capacity in kWh
Images of a car in structured data
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 & 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