Get an EVSE's live status

GET

https://api.ocpplab.io/emsp/evses/:location_id/:evse_uid/status

GET

/emsp/evses/:location_id/:evse_uid/status

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

{
  "location": {
    "country_code": "NL",
    "party_id": "ABC",
    "location_id": "LOC-AMS-001"
  },
  "evse_uid": "EVSE-AMS-001-1",
  "connectors": [
    {
      "connector_id": "1",
      "standard": "IEC_62196_T2_COMBO",
      "max_electric_power": 150000,
      "status": "AVAILABLE"
    }
  ],
  "capabilities": [
    "RFID_READER",
    "REMOTE_START_STOP_CAPABLE"
  ],
  "evse_id": "NL*ABC*E1001*1",
  "status": "AVAILABLE",
  "status_updated_at": "2026-09-30T10:00:00Z"
}

Status of one EVSE with its connectors and capabilities, read live. Poll this before a remote start; it is never cached.

Authentication

AuthorizationBearer

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

Path parameters

location_idstringRequired1-39 characters

OCPI location id.

evse_uidstringRequired1-39 characters

OCPI EVSE uid.

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 EVSE's live status with its connectors.

locationobject

OCPI key of one location.

evse_uidstring

connectorslist of objects

capabilitieslist of strings

evse_idstring or nullOptional

statusstring or nullOptional

status_updated_atdatetime 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