List locations

GET

https://api.ocpplab.io/cpo/locations

GET

/cpo/locations

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

{
  "items": [
    {
      "id": 12,
      "location_id": "LOC-AMS-01",
      "publish": true,
      "address": "Stationsplein 1",
      "city": "Amsterdam",
      "country": "NLD",
      "coordinates": {
        "latitude": "52.37310",
        "longitude": "4.88970"
      },
      "time_zone": "Europe/Amsterdam",
      "last_updated": "2026-09-30T10:00:00Z",
      "revision": 1,
      "role": "CPO",
      "origin": "LOCAL",
      "country_code": "NL",
      "party_id": "OCP",
      "ocpi_version": "2.2.1",
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2026-09-01T09:00:00Z",
      "updated_at": "2026-09-30T10:00:00Z",
      "name": "Amsterdam depot",
      "postal_code": "1012AB",
      "parking_type": "PARKING_LOT",
      "facilities": [
        "TRAIN_STATION"
      ]
    }
  ],
  "offset": 0,
  "limit": 50
}

Your locations and those received from roaming partners, most recently changed first.

Authentication

AuthorizationBearer

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

Query parameters

country_codestring or nullOptionalformat: "^[A-Z]{2}$"=2 characters

Only this OCPI party country code, e.g. NL.

party_idstring or nullOptionalformat: "^[A-Z0-9]{3}$"=3 characters

Only this OCPI party id, e.g. OCP.

originenum or nullOptional

LOCAL rows are yours; REMOTE rows came from a roaming partner.

Allowed values:

publishboolean or nullOptional

Only published (true) or unpublished (false) locations.

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