Search by text or EVSE id

GET

https://api.ocpplab.io/emsp/locations/search

GET

/emsp/locations/search

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.locations.search({
        evse_id: "NL*ABC*E1001*1",
        lat: 52.37,
        lon: 4.89,
    });
}
main();

{
  "data": [
    {
      "uid": "3f2b8c1d-6e4a-4b7f-9c2d-8a1e5f0b7c34",
      "country_code": "NL",
      "party_id": "ABC",
      "location_id": "LOC-AMS-001",
      "source": "PARTNER_OCPI",
      "evse_count": 4,
      "available_count": 3,
      "connector_standards": [
        "IEC_62196_T2_COMBO"
      ],
      "tariff_ids": [
        "TARIFF-DC-FAST"
      ],
      "name": "Amsterdam Zuid",
      "address": "Strawinskylaan 1",
      "city": "Amsterdam",
      "country": "NLD",
      "latitude": 52.338,
      "longitude": 4.872,
      "max_power_kw": 150
    }
  ]
}

Text search on name, address and city (q), EVSE id lookup (evse_id, as printed on the QR code; * and case are ignored), or both. Nearest first when lat and lon are given. Returns at most limit matches with no next page: refine the query to narrow it.

Authentication

AuthorizationBearer

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

Query parameters

qstring or nullOptional2-255 characters

Text in name, address or city.

evse_idstring or nullOptional1-255 characters

eMI3 EVSE id as printed on the QR code, e.g. NL*ABC*E1001*1.

latdouble or nullOptional-90-90

Your latitude (WGS84); send with lon.

londouble or nullOptional-180-180

Your longitude (WGS84); send with lat.

limitintegerOptional1-50Defaults to 10

Maximum results (default 10, max 50).

Response

Matching locations, nearest first when lat/lon are given.

datalist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error