---
title: "Electric cars: battery, range and how they charge"
method: GET
path: "/v1/vehicles"
---

# Electric cars: battery, range and how they charge

`GET /v1/vehicles`

## Request

- Base URL: `https://api.chargealong.io`
- URL: `https://api.chargealong.io/v1/vehicles`
- Auth: none required

Every car ChargeAlong holds figures for, sorted by brand. Usable battery in kWh, energy consumption, the range those two give, the fastest AC and DC power the car accepts, its plugs, and its charging curve where the source has measured one.

`curve_is_generic` is true when the curve is the shape the dataset applies to cars it has not measured. Treat those as an estimate rather than as that model's own curve.

Figures from Open EV Data (github.com/KilowattApp/open-ev-data), MIT licensed with attribution required: credit "Open EV Data" wherever you use them. ChargeAlong does not measure cars and states what that dataset says.

The list is built into this API rather than held in its database, so it changes only when the API is deployed and may be cached for a day.

## Query parameters

- `q` string
- `limit` integer
- `all` boolean

## Response `200`

The cars, each with its battery, range, charging powers, plugs and curve, and the source they came from

- VehiclesResponse: Electric cars, with where the figures come from.
  - `data` Vehicle[], required: The cars.
    - `slug` string, required: The car in URLs.
    - `brand` string, required: The maker.
    - `model` string, required: The model.
    - `variant` string: The variant, where there is one.
    - `year` integer: Model year, where known.
    - `source_id` string, required: Open EV Data's own id for the record.
    - `battery_kwh` number, required: Usable battery capacity, kWh.
    - `consumption_kwh_100km` number: Energy use, kWh per 100 km, where known.
    - `range_km` integer: Range in km, derived: the battery over the consumption.
    - `ac_kw` number: Fastest AC charging, kW.
    - `ac_ports` string[]: AC connector standards the car takes.
    - `dc_kw` number: Fastest DC charging, kW.
    - `dc_ports` string[]: DC connector standards the car takes.
    - `curve` CurvePoint[]: The DC charging curve: power by state of charge.
      - `pct` integer, required: State of charge, percent.
      - `power_kw` number, required: Power the car draws at that state of charge, kW.
    - `curve_is_generic` boolean: The curve is the dataset's default shape, not this car's measured one: an estimate.
    - `voltage_v` integer: Battery architecture voltage, V.
  - `source` VehicleSource, required: Where the vehicle figures come from. Credit it where you show them.
    - `name` string, required: The dataset: Open EV Data.
    - `url` string, uri, required: Where it is published.
    - `licence` string, required: Its licence.
  - `generated_at` string, date-time, required: When this answer was generated, UTC. Answers are cached, so it can be up to an hour old.

---

[API](https://skmtc.dev/chargealong/apis/chargealong-api.md) · [All operations](https://skmtc.dev/chargealong/apis/chargealong-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chargealong/apis/chargealong-api/revisions/f7968808e434?raw)