v1

latestOpenAPI 3.0.12026-07-243686491.1 MB

Charge Points

Retrieve a list of charge points

Required scope: charge-points:read </br>Organization authorization: supported

get/api/v1/charge-points

Query parameters

pageinteger

page number to retrieve (starts with 0)

perPageinteger

number of items per page (between 1 and 100, default 10)

siteIdinteger nullable

Allows to filter list of charge points by a site id

Example:13

teamIdinteger nullable

Allows to filter list of charge points by a team id

Example:19

partnerExternalIdstring nullable

Filter charge points by partnerExternalId, to filter only resources without partnerExternalId use partnerExternalId=""

Example:1

sortByLocationstring nullable

lat,long coordinates. If supplied, the Charge Points will be sorted in nearest first order relativeto this point. (Format: 55.7096,12.5856, -8.050000, -34.900002)

Example:55.7096,12.5856

boundingBoxstring nullable

Bounding box coordinates for filtering. The format should be 'minLat,minLon,maxLat,maxLon'

Example:55.0,12.0,56.0,13.0

operatorIdinteger nullable

Allows filtering charge point by operatorId.</br>*Note:*The operatorId must be in the consumer’s operatorIds or, if empty, belong to the organization’s sub-operators.

Example:1

includeDeletedboolean

Includes deleted resources in the response

includePublicboolean

Includes public charge points from other operators in the responseNote: Only supported from Version 2024-07-01

Various types of Charge Point states. Definitions:

available - The charge point is available for charging.
busy - The charge point is currently in use.
busy-blocked - The charge point is currently in use and blocked.
busy-charging - The charge point is currently in use and charging.
busy-non-charging - The charge point is currently in use and not charging.
busy-non-released - The charge point is currently in use and not released.
busy-reserved - The charge point is currently in use and reserved.
busy-scheduled - The charge point is currently in use and scheduled.
error - The charge point is in an error state.
disconnected - The charge point is disconnected from Monta.
passive - The charge point is in a passive state, charging can only be controlled locally.
maintenance - The charge point is in maintenance mode.
exempt - The charge point is exempt from downtime reporting due to external factors.

fromUpdatedDatestring date-time nullable

Filter to retrieve charge points where updatedAt >= fromUpdatedDate (ISO8601: yyyy-MM-ddTHH:mm:ssZ)

Example:2025-06-26T09:30:03Z

Response

List of charges points that match the criteria

Example response

{
  "data": [
    {
      "id": 1,
      "teamId": 1,
      "partnerExternalId": "ACME-12345",
      "siteId": 42,
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "deletedAt": "2022-05-12T16:56:45.99Z",
      "activeAt": "2022-05-12T15:56:45.91Z",
      "name": "Monta CPH HQ",
      "visibility": "public",
      "maxKW": 150,
      "maxKw": 150,
      "type": "ac",
      "note": "In order to access this charge point enter 0000 as code at the gate.",
      "operatorNote": "Installer note: XYZ",
      "state": "available",
      "location": {
        "coordinates": {
          "latitude": 55.6760968,
          "longitude": 12.5683371
        },
        "addressLabel": "Strandboulevarden 122, 5. sal, 2100 København, Denmark",
        "address": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "country": "Denmark",
          "countryAreaId": 1
        }
      },
      "connectors": [
        {
          "id": 1,
          "identifier": "ccs",
          "name": "CCS"
        }
      ],
      "lastMeterReadingKwh": 913.2,
      "meterId": "2200019107351",
      "cablePluggedIn": true,
      "chargePointModelId": 42,
      "brandName": "Easee",
      "modelName": "Easee - Home",
      "firmwareVersion": "v1",
      "evseId": "DK*MON*E2",
      "priceGroupId": 42,
      "costGroupId": 42,
      "roamingPriceGroupId": 42,
      "sponsoredPriceGroupId": 42,
      "scheduleId": 42,
      "isActive": true,
      "reservable": true,
      "simCard": {
        "imsi": "310150123456789",
        "iccid": "8931501234567890123"
      },
      "roaming": true,
      "lastConnectedAt": "2023-01-18T00:00:00Z",
      "disconnectedAt": "2023-01-01T00:00:00Z",
      "occupied": true,
      "protocolData": {
        "ocpp": {
          "updatedAt": "2025-02-27T15:56:45.91Z"
        }
      },
      "metadata": {
        "busCompatible": true,
        "motorcycleCompatible": true,
        "lorryCompatible": true,
        "personalVehicleCompatible": true,
        "additionalParkingFeesPolicy": true,
        "customersOnlyPolicy": true,
        "evOnlyPolicy": true,
        "parkingOnlyWhileChargingPolicy": true,
        "floorLevel": "first",
        "cableLength": 100,
        "behindBarrierPolicy": true,
        "hdvParkingSpot": {
          "height": 400,
          "width": 300,
          "length": 600,
          "weight": 5000,
          "angledOrientation": true,
          "turningRadius": 3.5,
          "cpPosition": "null"
        },
        "dangerousGoodsAllowed": true,
        "rigidVehiclesAllowed": true,
        "vehicleAccessibility": "wheelchair_accessible",
        "overnightParkingAllowed": true,
        "accessConditions": "permit_required",
        "barrier": true,
        "trailerPullThrough": true
      },
      "smartChargeSetting": "optional",
      "userId": 42,
      "autoRegisterRfid": true
    }
  ]
}