---
title: "List vehicles across your sites"
method: GET
path: "/api/v1/energy/vehicles"
tags: ["Energy Vehicles"]
---

# List vehicles across your sites

`GET /api/v1/energy/vehicles`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/energy/vehicles`
- Auth: HTTP bearer

Required scope: `energy:read`

Returns the vehicles registered on the sites of your operator(s).

🚧 **BETA** — This endpoint is currently in the BETA phase and its response structure may change in the future.

📘 **Feature flag required** — This endpoint is not available by default. It must be explicitly enabled for your operator account upon request. Please contact your Monta Business Partner to request access to this feature.

## Query parameters

- `search` string
- `page` integer
- `perPage` integer

## Response `200`

get-energy-vehicles 200 response

- OffsetBasedResponse23
  - `data` EnergyVehicleListItem[], required
    - `vehicleId` integer, nullable
    - `vehicleIdTag` string, required
    - `batteryCapacityKwh` number, double, nullable
    - `type` 'PRICE_OPTIMIZE' | 'CHARGE_NOW', required
    - `siteId` integer, required
    - `siteName` string, required
    - `operatorId` integer, required
    - `maxKwAc` number, double, nullable
    - `maxKwDc` number, double, nullable
    - `integrationCapacityKwh` number, double, nullable
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

## Changes

- **2026-11-03** `0ca400461c52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/energy/vehicles/get.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)