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.

Explore on the playground

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

  • query • CarList
    Deprecated

    Deprecated: Not used anymore

  • search • string

    Search for cars by make, model, version and chargetrip version

  • filter • CarListFilter

    Filter car result

  • size • int

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

  • page • int

    Page number to return, default: 0

    • Frequently used fields

  • id • 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

  • externalId • string
    Deprecated

    ID provided by a car data source as the row ID

  • make • string
    Deprecated

    Car manufacturer

  • carModel • string
    Deprecated

    Car model

  • edition • string
    Deprecated

    Car edition

  • chargetripEdition • 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 • 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 • boolean
    Deprecated

    Cars that support fast charging have a minimum charging speed of 43 Kwh. Cars without support for fast charging used in a newRoute mutation will return an error

  • mode • enum • CarMode
    Deprecated

    Current production mode of a car

  • seats • int
    Deprecated

    Number of seats

  • batteryUsableKwh • float
    Deprecated

    Usable battery capacity in kWh

  • batteryFullKwh • float
    Deprecated

    Full battery capacity in kWh

  • imagesData • object • CarImageData
    Deprecated

    Images of a car in structured data

  • power • float
    Deprecated
  • acceleration • float
    Deprecated
  • topSpeed • float
    Deprecated
  • torque • float
    Deprecated
  • batteryEfficiency • object • CarBatteryEfficiency
    Deprecated
  • weight • float
    Deprecated
  • height • int
    Deprecated
  • width • int
    Deprecated
  • consumption • object • CarExtraConsumption
    Deprecated
  • petrolConsumption • float
    Deprecated
  • chargingOffset • json
    Deprecated
  • auxConsumption • float
    Deprecated
  • bmsConsumption • float
    Deprecated
  • dragCoefficient • float
    Deprecated
  • tirePressure • float
    Deprecated
  • motorEfficiency • float
    Deprecated
  • drivelineEfficiency • float
    Deprecated
  • regenEfficiency • 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.