List tariffs

GET

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

GET

/emsp/tariffs

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.tariffs.list({
        limit: 50,
        country_code: "NL",
        party_id: "ABC",
    });
}
main();

{
  "data": [
    {
      "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"
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "has_next": false,
    "end_cursor": "NL:ABC:TARIFF-DC-FAST"
  }
}

Tariffs of the CPOs you reach, in OCPI 2.2.1 shape whatever version the CPO spoke, optionally for one CPO.

Authentication

AuthorizationBearer

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

Query parameters

country_codestring or nullOptionalformat: "^[A-Z]{2}$"

Only this CPO country code, e.g. NL.

party_idstring or nullOptionalformat: "^[A-Z0-9]{3}$"

Only this CPO party id, e.g. ABC.

afterstring or nullOptionalformat: "^[A-Z]{2}:[A-Z0-9]{3}:.{1,36}$"

Cursor: the previous page’s pagination.end_cursor (country_code:party_id:tariff_id). Omit it for the first page.

limitintegerOptional1-200Defaults to 50

Maximum rows per page (default 50, max 200).

Response

One page of tariffs in OCPI 2.2.1 shape.

datalist of objects

paginationobject

Spirii cursor page. Pass end_cursor as the next after value.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error