Get a tariff

GET

https://api.ocpplab.io/emsp/tariffs/:tariff_id

GET

/emsp/tariffs/:tariff_id

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.tariffs.get({
        tariff_id: "TARIFF-DC-FAST",
        country_code: "NL",
        party_id: "ABC",
    });
}
main();

{
  "country_code": "NL",
  "party_id": "ABC",
  "id": "TARIFF-DC-FAST",
  "currency": "EUR",
  "last_updated": "2026-09-30T10:00:00Z",
  "type": "REGULAR",
  "tariff_alt_text": [
    {
      "language": "en",
      "text": "0.59 EUR/kWh + 0.35 per session"
    }
  ],
  "elements": [
    {
      "price_components": [
        {
          "type": "ENERGY",
          "price": "0.59",
          "step_size": 1,
          "vat": "21.0"
        },
        {
          "type": "FLAT",
          "price": "0.35",
          "step_size": 1,
          "vat": "21.0"
        }
      ]
    }
  ]
}

One tariff in OCPI 2.2.1 shape, addressed by the CPO's country code and party id.

Authentication

AuthorizationBearer

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

Path parameters

tariff_idstringRequired1-36 characters

OCPI tariff id.

Query parameters

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

The CPO's OCPI country code, e.g. NL.

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

The CPO's OCPI party id, e.g. ABC.

Response

The tariff in OCPI 2.2.1 shape.

country_codestring

party_idstring

idstring

currencystring

last_updateddatetime

typestring or nullOptional

tariff_alt_textlist of objects or nullOptional

tariff_alt_urlstring or nullOptional

min_priceobject or nullOptional

max_priceobject or nullOptional

elementslist of objects or nullOptional

start_date_timedatetime or nullOptional

end_date_timedatetime or nullOptional

energy_mixmap from strings to any or nullOptional

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error