List charge points

GET

https://api.ocpplab.io/cpo/charge-points

GET

/cpo/charge-points

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.chargePoints.list({
        is_online: true,
        limit: 50,
        offset: 0,
    });
}
main();

{
  "items": [
    {
      "id": "5f0c1a2b-3c4d-4e5f-8a9b-0c1d2e3f4a5b",
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "charge_point_id": "CP-AMS-001",
      "is_online": true,
      "is_roaming": true,
      "use_status_notification_0": false,
      "revision": 1,
      "ocpp_version": "ocpp2.0.1",
      "charge_point_vendor": "ABB",
      "charge_point_model": "Terra AC W22",
      "firmware_version": "1.8.2",
      "last_heartbeat": "2026-09-30T10:00:00Z",
      "max_power_kw": 22,
      "connector_count": 2,
      "location_id": 12
    }
  ],
  "offset": 0,
  "limit": 50
}

Your chargers, sorted by OCPP identity. Online state, heartbeat and firmware come from the chargers themselves.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

location_idinteger or nullOptional>=1

Only this location, by its numeric id (not its OCPI location id).

is_onlineboolean or nullOptional

Only connected (true) or disconnected (false) chargers.

ocpp_versionenum or nullOptional

Only chargers speaking this OCPP version.

Allowed values:

offsetintegerOptional>=0Defaults to 0

Rows to skip. Pass the previous page’s next_offset to continue.

limitintegerOptional1-200Defaults to 50

Maximum rows per page (default 50, max 200).

Response

One page of results; next_offset is null on the last page.

itemslist of objects

offsetinteger

limitinteger

next_offsetinteger or nullOptional

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error