Link a location to a voucher group

POST

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

POST

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

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

{
  "id": 12,
  "location_id": "LOC-AMS-01",
  "publish": true,
  "address": "Stationsplein 1",
  "city": "Amsterdam",
  "country": "NLD",
  "coordinates": {
    "latitude": "52.37310",
    "longitude": "4.88970"
  },
  "time_zone": "Europe/Amsterdam",
  "last_updated": "2026-09-30T10:00:00Z",
  "revision": 1,
  "role": "CPO",
  "origin": "LOCAL",
  "country_code": "NL",
  "party_id": "OCP",
  "ocpi_version": "2.2.1",
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "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 apply vouchers.

Authentication

AuthorizationBearer

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

Path parameters

idintegerRequired>=1

The voucher 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

location_idstring

publishboolean

addressstring

citystring

countrystring

coordinatesobject

time_zonestring

last_updateddatetime

revisioninteger

roleenum or any

originenum or any

country_codestring

party_idstring

ocpi_versionenum or any

organization_idstring

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_typeenum or any 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

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