---
title: "Retrieve charge points / sites for map"
method: GET
path: "/api/v1/charge-points/map"
tags: ["Charge Points"]
---

# Retrieve charge points / sites for map

`GET /api/v1/charge-points/map`

Required scope: `map:read`. **RateLimit-Policy: `Fair-Use`**

## Query parameters

- `topLatitude` number, double, required — top (north) latitude value (between `-90`-`90`)
- `rightLongitude` number, double, required — right (east) longitude value (between `-180`-`180`)
- `bottomLatitude` number, double, required — bottom (south) latitude value (between `-90`-`90`)
- `leftLongitude` number, double, required — left (west) longitude value (between `-180`-`180`)
- `centerLatitude` number, double, required — latitude value of the center coordinate of your map (between `-90`-`90`)
- `centerLongitude` number, double, required — longitude value of the center coordinate of your map (between `-180`-`180`)
- `zoom` number, double, required — zoom level of the map (between `1`-`15`)
- `includeBusy` boolean, nullable, required — If true, busy charge points are returned as well. Otherwise, only charge points that are active and not in use are returned.
- `includeAllOperators` boolean, nullable, required — If true, all public charge points are returned. Otherwise, only charge points owned by the operator/teams matching the request credentials.

## Response `200`

List of charges points /sites that match the criteria

- MapResult
  - `chargePoints` MapResultChargePoint[], required — list of all charge points found in that area
    - `id` integer — Id of this charge point
    - `siteId` integer, nullable — Id of the site
    - `name` string, nullable — Name of the site
    - `visibility` 'private' | 'public', required — Indicates if this charge point is `public` or `private`
    - `maxKW` number, double, nullable — Deprecated (will be removed by 01.04.24), use `maxKw` field instead.
    - `maxKw` number, double, nullable — Max KW available at this charge point.
    - `type` 'ac' | 'dc', nullable — Type of charge point (`AC` / `DC`)
    - `note` string, nullable — A note you have entered for this charge point, e.g. via our Portal.
    - `state` 'available' | 'busy' | 'error' | 'disconnected' | 'passive' | 'other', nullable — Chargepoint state
    - `location` Location, required
      - `coordinates` Coordinates
        - `latitude` number, double — Latitude value of coordinate
        - `longitude` number, double — Longitude value of coordinate
      - `addressLabel` string, nullable — The full address.
      - `address` PartialAddress
        - `address1` string, nullable — First line of address
        - `address2` string, nullable — Second line of address
        - `address3` string, nullable — Third line of address
        - `zip` string, nullable — Zip-code
        - `city` string, nullable — City (readable)
        - `province` string, nullable — Province
        - `country` string, nullable — Country (readable)
        - `countryAreaId` integer, nullable — Country area id
    - `connectors` ChargePointConnector[], required — List of supported connector types at this charge point (e.g. type-2, ccs, ...)
      - `id` integer — Id of this connector
      - `identifier` string, required — Identifier of connector
      - `name` string, required — Readable name of connector
    - `deeplinks` ChargePointDeeplinks, required
      - `app` string, uri, required — Follow this link to open the Monta App with this charge point
      - `web` string, uri, required — Follow this link to open the Monta Web App with this charge point
  - `sites` MapResultSite[], required — list of all sites found in that area
    - `id` integer — Id of the site
    - `name` string, required — Name of the site
    - `chargePointCount` integer — Number of charge points at this site
    - `maxKW` number, double, nullable — Deprecated (will be removed by 01.04.24), use `maxKw` field instead.
    - `maxKw` number, double, nullable — Max KW available at this site.
    - `type` 'ac' | 'dc', nullable — Type of charge points at this site (`AC` / `DC`)
    - `visibility` 'private' | 'public', required — Indicates if this site is `public` or `private`
    - `note` string, nullable — A note you have entered for this site, e.g. via our Portal.
    - `location` Location, required
      - `coordinates` Coordinates
        - `latitude` number, double — Latitude value of coordinate
        - `longitude` number, double — Longitude value of coordinate
      - `addressLabel` string, nullable — The full address.
      - `address` PartialAddress
        - `address1` string, nullable — First line of address
        - `address2` string, nullable — Second line of address
        - `address3` string, nullable — Third line of address
        - `zip` string, nullable — Zip-code
        - `city` string, nullable — City (readable)
        - `province` string, nullable — Province
        - `country` string, nullable — Country (readable)
        - `countryAreaId` integer, nullable — Country area id
    - `connectors` ChargePointConnector[], required — List of supported connector types at this site (e.g. type-2, ccs, ...)
      - `id` integer — Id of this connector
      - `identifier` string, required — Identifier of connector
      - `name` string, required — Readable name of connector
  - `cluster` MapResultCluster[], required — list of all clusters (of charge points and sites) found in that area
    - `coordinates` Coordinates, required
      - `latitude` number, double — Latitude value of coordinate
      - `longitude` number, double — Longitude value of coordinate
    - `count` integer — Number of entities (Charge points and sites) clustered.

## 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

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/versions/517e18f11015/schema)