Get a location

GET

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

GET

/cpo/locations/:location_id

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.locations.get({
        location_id: "LOC-AMS-01",
    });
}
main();

{
  "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"
  ]
}

One location by OCPI id. If two parties use the same id, pass country_code and party_id (409 otherwise).

Authentication

AuthorizationBearer

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

Path parameters

location_idstringRequired1-36 characters

OCPI location id.

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.

Response

The requested object.

idinteger

location_idstring

publishboolean

addressstring

citystring

countrystring

coordinatesobject

time_zonestring

last_updateddatetime

revisioninteger

roleenum or any

originenum or any

country_codestring

party_idstring

ocpi_versionenum or any

organization_idstring

created_atdatetime

updated_atdatetime

publish_allowed_tolist of objects or nullOptional

namestring or nullOptional

postal_codestring or nullOptional

statestring or nullOptional

related_locationslist of objects or nullOptional

parking_typeenum or any or nullOptional

parking_placeslist of objects or nullOptional

directionslist of objects or nullOptional

operatorobject or nullOptional

suboperatorobject or nullOptional

ownerobject or nullOptional

facilitieslist of strings or nullOptional

opening_timesobject or nullOptional

charging_when_closedboolean or nullOptional

imageslist of objects or nullOptional

energy_mixobject or nullOptional

help_phonestring or nullOptional

ocpp_versionstring or nullOptional

Errors

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error