Assign a tariff to a connector

POST

https://api.ocpplab.io/cpo/tariffs/:tariff_id/assign

POST

/cpo/tariffs/:tariff_id/assign

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.tariffs.assign({
        tariff_id: "TARIFF-AC-STD",
        location_id: "LOC-AMS-01",
        evse_uid: "NL*OCP*E1001*1",
        connector_id: "1",
        charge_point_id: "CP-AMS-001",
    });
}
main();

{
  "tariff_id": "TARIFF-AC-STD",
  "assigned": [
    {
      "id": 9001,
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "country_code": "NL",
      "party_id": "OCP",
      "location_id": "LOC-AMS-01",
      "evse_uid": "NL*OCP*E1001*1",
      "connector_id": "1",
      "tariff_id": "TARIFF-AC-STD",
      "effective_from": "2026-09-30T10:00:00Z",
      "created_at": "2026-09-30T10:00:00Z",
      "updated_at": "2026-09-30T10:00:00Z",
      "charge_point_id": "CP-AMS-001"
    }
  ]
}

Prices new sessions on one OCPI connector with this tariff. With replace (the default) the connector’s other tariffs are retired; sessions already started keep their price.

Authentication

AuthorizationBearer

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

Path parameters

tariff_idstringRequired1-36 characters

OCPI tariff id.

Request

This endpoint expects an object.

location_idstringRequired1-36 characters

evse_uidstringRequired1-36 characters

connector_idstringRequired1-36 characters

charge_point_idstring or nullOptional<=36 characters

replaceboolean or nullOptionalDefaults to true

Response

The connector link that now prices new sessions.

tariff_idstring

assignedlist of objects

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