Create a tariff

POST

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

POST

/cpo/tariffs

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.tariffs.create({
        tariff_id: "TARIFF-AC-STD",
        currency: "EUR",
        country_code: "NL",
        party_id: "OCP",
        elements: [
            {
                price_components: [
                    {
                        type: "ENERGY",
                        price: "0.35",
                        step_size: 1,
                    },
                ],
            },
        ],
        type: "REGULAR",
        ocpi_version: "2.2.1",
    });
}
main();

{
  "id": 7,
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "tariff_id": "TARIFF-AC-STD",
  "country_code": "NL",
  "party_id": "OCP",
  "currency": "EUR",
  "elements": [
    {
      "price_components": [
        {
          "type": "ENERGY",
          "price": "0.35",
          "step_size": 1
        }
      ]
    }
  ],
  "role": "CPO",
  "origin": "LOCAL",
  "ocpi_version": "2.2.1",
  "last_updated": "2026-09-30T10:00:00Z",
  "revision": 1,
  "created_at": "2026-09-01T09:00:00Z",
  "updated_at": "2026-09-30T10:00:00Z",
  "type": "REGULAR"
}

Creates a tariff for the OCPI party in the body. Assign it to connectors with POST /cpo/tariffs/{tariff_id}/assign so it prices new sessions.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

tariff_idstringRequired1-36 characters

currencystringRequiredformat: "^[A-Z]{3}$"

country_codestringRequiredformat: "^[A-Z]{2}$"

party_idstringRequiredformat: "^[A-Z0-9]{3}$"

elementslist of objectsRequired

typeenum or nullOptional

OCPI TariffType stored on ocpp.ocpp_tariffs.type.

Allowed values:

tariff_alt_textlist of objects or nullOptional

tariff_alt_urlstring or nullOptional<=255 characters

min_priceobject or nullOptional

max_priceobject or nullOptional

preauthorize_amountdouble or string or nullOptional

tax_includedenum or nullOptional

OCPI tax flag stored on ocpp.ocpp_tariffs.tax_included.

Allowed values:

start_date_timedatetime or nullOptional

end_date_timedatetime or nullOptional

energy_mixobject or nullOptional

ocpi_versionenum or nullOptionalDefaults to 2.3.0

OCPI version string stored on the tariff row.

Allowed values:

Response

The created object.

idinteger

organization_idstring

tariff_idstring

country_codestring

party_idstring

currencystring

elementslist of objects

rolestring

originenum or any

ocpi_versionenum or any

last_updateddatetime

revisioninteger

created_atdatetime

updated_atdatetime

typeenum or any or nullOptional

tariff_alt_textlist of objects or nullOptional

tariff_alt_urlstring or nullOptional

min_priceobject or nullOptional

max_priceobject or nullOptional

preauthorize_amountstring or nullOptional

tax_includedenum or any or nullOptional

start_date_timedatetime or nullOptional

end_date_timedatetime or nullOptional

energy_mixobject or nullOptional

ocpp_versionstring or nullOptional

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