> ## Documentation Index
> Fetch the complete documentation index at: https://smartcar.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Battery Capacity (Canada Only)

> Returns the rated capacity of the electric vehicle's high voltage battery for Canadian based vehicles.

<Info>
  This endpoint is only for Canadian based vehicles. Please visit [this page](/api-reference/get-nominal-capacity) for vehicles based in the US and Europe as we work towards consolidating all markets into a single endpoint.
</Info>

<Warning>
  The Vehicles API v2.0 will be deprecated by **Q4 of 2026**. We recommend migrating to the [latest version](/api-reference/intro) as soon as possible to ensure continued support and access to new features.
</Warning>

## Permission

`read_battery`

## Request

**Path**

<Snippet file="api-reference/path-vehicle-id.mdx" />

<RequestExample />

## Response

<ResponseField name="capacity" type="number">
  The rated capacity of the battery in kWh.
</ResponseField>

<ResponseExample>
  ```json Example Response theme={null}
  {
      "capacity": 28
  }
  ```
</ResponseExample>