Create or replace a location

POST

https://api.ocpplab.io/ocpi/cpo/:version/locations

POST

/ocpi/cpo/:version/locations

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.ocpi.cpoData.upsertLocation({
        version: "221",
        push_to_partner_id: 7,
        body: {
            id: "LOC-AMS-1",
            publish: true,
            name: "Amsterdam depot",
            address: "Stationsplein 1",
            city: "Amsterdam",
            postal_code: "1012 AB",
            country: "NLD",
            coordinates: {
                latitude: "52.379189",
                longitude: "4.899431",
            },
            time_zone: "Europe/Amsterdam",
            evses: [
                {
                    uid: "EVSE-AMS-1-1",
                    evse_id: "NL*OCP*E0001*1",
                    status: "AVAILABLE",
                    connectors: [
                        {
                            id: "1",
                            standard: "IEC_62196_T2",
                            format: "SOCKET",
                            power_type: "AC_3_PHASE",
                            max_voltage: 230,
                            max_amperage: 32,
                            last_updated: "2026-09-30T10:00:00Z",
                        },
                    ],
                    last_updated: "2026-09-30T10:00:00Z",
                },
            ],
            last_updated: "2026-09-30T10:00:00Z",
        },
    });
}
main();

{
  "location_id": "LOC-AMS-1",
  "created": true,
  "push": {
    "partner_id": 7,
    "module": "locations",
    "object_id": "LOC-AMS-1",
    "status": "SUCCESS",
    "http_status": 200,
    "ocpi_status_code": 1000,
    "duration_ms": 142
  }
}

Stores a full OCPI Location for the path version, replacing any existing one with the same id. The owner country_code and party_id are set to this organization’s own identity. Pass push_to_partner_id to also push it to that partner right away.

Authentication

AuthorizationBearer

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

Path parameters

versionenumRequired

OCPI version: 211 (2.1.1), 221 (2.2.1) or 230 (2.3.0).

Allowed values:

Query parameters

push_to_partner_idinteger or nullOptional>=1

Also push the written object to this roaming partner right away.

Request

This endpoint expects a map from strings to any.

Response

Successful Response

location_idstring

createdboolean or nullOptional

pushobject or nullOptional

Outcome of pushing one object to a roaming partner.

Errors

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error