Link a location to a token group

POST

https://api.ocpplab.io/cpo/token-groups/:id/locations/:location_id

POST

/cpo/token-groups/:id/locations/:location_id

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

{
  "id": 12,
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "location_id": "LOC-AMS-01",
  "country_code": "NL",
  "party_id": "OCP",
  "publish": true,
  "address": "Stationsplein 1",
  "city": "Amsterdam",
  "country": "NLD",
  "coordinates": {
    "latitude": "52.37310",
    "longitude": "4.88970"
  },
  "time_zone": "Europe/Amsterdam",
  "role": "CPO",
  "origin": "LOCAL",
  "ocpi_version": "2.2.1",
  "last_updated": "2026-09-30T10:00:00Z",
  "revision": 1,
  "created_at": "2026-09-30T10:00:00Z",
  "updated_at": "2026-09-30T10:00:00Z",
  "name": "Amsterdam depot",
  "postal_code": "1012AB",
  "parking_type": "PARKING_LOT",
  "facilities": [
    "TRAIN_STATION"
  ]
}

Link one of your OCPI locations to the group, for your records; chargers do not enforce it.

Authentication

AuthorizationBearer

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

Path parameters

idintegerRequired>=1

The token group’s id.

location_idstringRequired1-36 characters

OCPI location id.

Query parameters

country_codestring or nullOptionalformat: "^[A-Z]{2}$"=2 characters

OCPI party country code, e.g. NL. Pass it with party_id when the location id is used by more than one party.

party_idstring or nullOptionalformat: "^[A-Z0-9]{3}$"=3 characters

OCPI party id, e.g. OCP. Pass it with country_code when the location id is used by more than one party.

Response

The linked location.

idinteger

organization_idstring

location_idstring

country_codestring

party_idstring

publishboolean

addressstring

citystring

countrystring

coordinatesobject

time_zonestring

rolestring

originstring

ocpi_versionstring

last_updateddatetime

revisioninteger

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_typestring 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

deleted_atdatetime 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