Get a location

GET

https://api.ocpplab.io/emsp/locations/by-id/:location_id

GET

/emsp/locations/by-id/:location_id

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.locations.get({
        location_id: "LOC-AMS-001",
        country_code: "NL",
        party_id: "ABC",
    });
}
main();

{
  "uid": "3f2b8c1d-6e4a-4b7f-9c2d-8a1e5f0b7c34",
  "source": "PARTNER_OCPI",
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "country_code": "NL",
  "party_id": "ABC",
  "location_id": "LOC-AMS-001",
  "cpo_id": "NL*ABC",
  "last_updated": "2026-09-30T10:00:00Z",
  "evses": [
    {
      "uid": "8d0c7e2a-1b3f-4c5d-9e6f-0a1b2c3d4e5f",
      "evse_uid": "EVSE-AMS-001-1",
      "connectors": [
        {
          "uid": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
          "evse_uid": "EVSE-AMS-001-1",
          "connector_id": "1",
          "standard": "IEC_62196_T2_COMBO",
          "format": "CABLE",
          "power_type": "DC",
          "max_electric_power": 150000,
          "tariff_ids": [
            "TARIFF-DC-FAST"
          ]
        }
      ],
      "evse_id": "NL*ABC*E1001*1",
      "status": "AVAILABLE",
      "capabilities": [
        "RFID_READER",
        "REMOTE_START_STOP_CAPABLE"
      ]
    }
  ],
  "name": "Amsterdam Zuid",
  "address": "Strawinskylaan 1",
  "city": "Amsterdam",
  "postal_code": "1077 XW",
  "country": "NLD",
  "time_zone": "Europe/Amsterdam",
  "parking_type": "PARKING_GARAGE",
  "publish": true,
  "latitude": "52.338000",
  "longitude": "4.872000",
  "facilities": [
    "CAFE"
  ],
  "tariff_summary": [
    {
      "summary": "€0.59/kWh + €0.35 per session",
      "tariff_id": "TARIFF-DC-FAST",
      "currency": "EUR",
      "per_kwh": "0.59",
      "session_fee": "0.35"
    }
  ]
}

One own or partner location with its EVSEs, connectors and tariff summary, addressed by the CPO's country code and party id.

Authentication

AuthorizationBearer

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

Path parameters

location_idstringRequired1-39 characters

OCPI location id.

Query parameters

country_codestringRequiredformat: "^[A-Z]{2}$"

The CPO's OCPI country code, e.g. NL.

party_idstringRequiredformat: "^[A-Z0-9]{3}$"

The CPO's OCPI party id, e.g. ABC.

Response

The location with its EVSEs, connectors and tariff summary.

uidstring

sourcestring

organization_idstring

country_codestring

party_idstring

location_idstring

cpo_idstring

last_updateddatetime

evseslist of objects

namestring or nullOptional

addressstring or nullOptional

citystring or nullOptional

postal_codestring or nullOptional

countrystring or nullOptional

time_zonestring or nullOptional

parking_typestring or nullOptional

publishboolean or nullOptional

latitudestring or nullOptional

longitudestring or nullOptional

facilitieslist of strings or nullOptional

tariff_summarylist of objects 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