---
title: "Search sites"
method: GET
path: "/api/v1/energy/sites/search"
tags: ["Energy Sites"]
---

# Search sites

`GET /api/v1/energy/sites/search`

## Request

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

Required scope: `energy:read`

Returns a page of your sites. `search` matches the site name, the exact site ID, or the identity of a charging station attached to the site.

🚧 **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`

search-energy-sites 200 response

- OffsetBasedResponse21
  - `data` SiteListItem[], required
    - `id` integer, required
    - `name` string, required
    - `isActive` boolean, required
    - `operatorId` integer, required
    - `teamId` integer, nullable
    - `numberOfEvses` integer, required
    - `numberOfSubgroups` integer, required
    - `currentPowerW` number, double, required
    - `comment` string, required
    - `phpSiteId` integer, nullable
    - `chargePointIds` string[], required
  - `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/sites/search/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)
