Get a location by uid

GET

https://api.ocpplab.io/emsp/locations/by-uid/:uid

GET

/emsp/locations/by-uid/:uid

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.locations.getByUid({
        uid: "3f2b8c1d-6e4a-4b7f-9c2d-8a1e5f0b7c34",
    });
}
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 location with its EVSEs, connectors and tariff summary, by its stable uid.

Authentication

AuthorizationBearer

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

Path parameters

uidstringRequiredformat: "uuid"

The location’s stable uid.

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

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error