---
title: "Retrieve a list of charge points sensors"
method: GET
path: "/api/v1/charge-point-sensors"
tags: ["Charge Points Sensors"]
---

# Retrieve a list of charge points sensors

`GET /api/v1/charge-point-sensors`

Required scope: `charge-points:read` </br>Organization authorization: `supported`</br></br>`Note`: Please be aware that this endpoint is currently in the BETA phase

## Query parameters

- `page` integer
- `perPage` integer
- `chargePointId` integer, nullable — Allows to filter list of charge points sensors by the charge point id
- `partnerExternalId` string, nullable — Filter charge points sensors by the partnerExternalId, to filter only resources without `partnerExternalId` *use* `partnerExternalId=""`
- `includeDeleted` boolean — Filter to include delete resources in the response

## Response `200`

List of charges point sensors that match the criteria

- OffsetBasedResponse50
  - `data` ChargePointSensor[], required
    - `id` integer — Id of this charge point sensor
    - `type` 'occupancy' | 'other', required — Various types of Charge Point Sensors. Definitions: * `occupancy` - The sensor is of type occupancy (presence). accept values for type occupancy are true, false or null
    - `operatorId` integer — The operator id to which this charge point sensor is belongs to
    - `chargePointId` integer, nullable — The charge point id to which this charge point sensor is assigned to
    - `externalId` string, nullable — External Id of this sensor, ideally it references the sensor id in your system
    - `partnerExternalId` string, nullable — External Id of this entity, managed by you
    - `value` string, nullable — Value this sensor is reporting, this is sensor specific, this value is managed by you
    - `valueUpdatedAt` string, date-time, nullable — Last date when charge point sensor was changed
    - `createdAt` string, date-time, required — Creation date of this charge point sensor
    - `updatedAt` string, date-time, required — Date this charge point sensor was last updated
    - `deletedAt` string, date-time, nullable — Date this charge point sensor was deleted
  - `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

---

[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/revisions/517e18f11015/schema)