Estimate the price of a session

POST

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

POST

/emsp/tariffs/estimate

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.tariffs.estimate({
        location: {
            country_code: "NL",
            party_id: "ABC",
            location_id: "LOC-AMS-001",
        },
        evse_uid: "EVSE-AMS-001-1",
        connector_id: "1",
        kwh: "30",
    });
}
main();

{
  "currency": "EUR",
  "tariff_id": "TARIFF-DC-FAST",
  "lines": [
    {
      "type": "ENERGY",
      "quantity": "30",
      "unit_price": "0.59",
      "amount": "17.70"
    },
    {
      "type": "FLAT",
      "quantity": "1",
      "unit_price": "0.35",
      "amount": "0.35"
    }
  ],
  "total_excl_vat": "18.05",
  "total_incl_vat": "21.84",
  "display": {
    "summary": "€0.59/kWh + €0.35 per session",
    "per_kwh": "0.59",
    "session_fee": "0.35"
  }
}

Prices a session on one connector from its tariff: energy, time, flat fee and parking lines, totals with and without VAT, and display strings.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

locationobjectRequired

OCPI key of one location.

evse_uidstringRequired1-39 characters

connector_idstringRequired1-36 characters

start_atdatetime or nullOptional

kwhdouble or string or nullOptional

minutesdouble or string or nullOptional

Response

Price lines, totals and display strings.

currencystring

tariff_idstring

lineslist of objects

total_excl_vatstring

total_incl_vatstring

displayobject

Driver-facing prices of the tariff’s unrestricted element, incl. VAT when known.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error