Tariff

Represents a pricing tariff for charging sessions. Defines the pricing structure including energy, time, flat fees, and idle charges.

country_codestring

ISO-3166 alpha-2 country code where this tariff applies.

currencystring

ISO-4217 currency code for this tariff.

uidstring

Unique identifier for the tariff.

start_date_timestring

Start date/time when this tariff becomes active. Format: RFC3339 in UTC timezone.

end_date_timestring

End date/time when this tariff expires. Format: RFC3339 in UTC timezone.

min_price Price

excl_vatnumber<double>

incl_vatnumber<double>

max_price Price

excl_vatnumber<double>

incl_vatnumber<double>

typestring

Type of tariff (e.g., AD_HOC_PAYMENT, REGULAR).

price_per_kwh Price

excl_vatnumber<double>

incl_vatnumber<double>

price_per_min Price

excl_vatnumber<double>

incl_vatnumber<double>

price_flat Price

excl_vatnumber<double>

incl_vatnumber<double>

price_per_min_parked Price

excl_vatnumber<double>

incl_vatnumber<double>

max_price_per_min_parkednumber<double>

Maximum price per minute for idle time.

grace_period_secondsstring<int64>

Grace period in seconds before idle charges begin.

idle_blackout_period IdleBlackoutPeriod

day_of_weekstring[]

start_time_of_daystring

end_time_of_daystring

price_modifiers OMNIPriceModifier[]

List of price modifiers that can adjust the base tariff.

Array [

uidstring

valuenumber<double>

typestring

vatnumber<double>

tariff_dimension_typesstring[]

]

grace_period_notification_secondsinteger<int32>

Seconds before grace period ends to send notification.

elements TariffElement[]

List of tariff elements with time/power restrictions.

Array [

uidstring

price_components PriceComponent[]

Array [

typestring

pricenumber<double>

vatnumber<double>

step_sizestring<int64>

]

restrictions TariffRestrictions

start_timestring

end_timestring

start_datestring

end_datestring

min_kwhnumber<double>

max_kwhnumber<double>

min_currentnumber<double>

max_currentnumber<double>

min_powernumber<double>

max_powernumber<double>

min_durationstring<int64>

max_durationstring<int64>

day_of_weekstring[]

reservationstring

max_average_powernumber<double>

reservation_min_kwhnumber<double>

reservation_max_kwhnumber<double>

advance_booking_days_minstring<int64>

advance_booking_days_maxstring<int64>

session_stagestring

]

tariff_alt_text DisplayText[]

Human-readable tariff description with i18n support.

Array [

languagestring

ISO 639-1 language code (e.g., "en", "nl", "de").

textstring

The localized text content.

]

tariff_alt_urlstring

URL to a web page with more tariff information.

max_price_thresholdnumber<double>

Maximum price threshold before stopping the session.

min_delta_wh_thresholdinteger<int32>

Minimum energy delta threshold for auto-stop.

consecutive_delta_below_threshold_to_stopinteger<int32>

Number of consecutive readings below threshold to trigger stop.

time_threshold_to_stop_secondsinteger<int32>

Time threshold in seconds to trigger auto-stop.

price_platform_flat Price

excl_vatnumber<double>

incl_vatnumber<double>

entity_codestring

Entity code of the CPO that owns this tariff.

last_updatedstring

Timestamp when this tariff was last updated. Format: RFC3339 in UTC timezone.

Tariff

{
  "country_code": "string",
  "currency": "string",
  "uid": "string",
  "start_date_time": "string",
  "end_date_time": "string",
  "min_price": {
    "excl_vat": 0,
    "incl_vat": 0
  },
  "max_price": {
    "excl_vat": 0,
    "incl_vat": 0
  },
  "type": "string",
  "price_per_kwh": {
    "excl_vat": 0,
    "incl_vat": 0
  },
  "price_per_min": {
    "excl_vat": 0,
    "incl_vat": 0
  },
  "price_flat": {
    "excl_vat": 0,
    "incl_vat": 0
  },
  "price_per_min_parked": {
    "excl_vat": 0,
    "incl_vat": 0
  },
  "max_price_per_min_parked": 0,
  "grace_period_seconds": "string",
  "idle_blackout_period": {
    "day_of_week": [
      "string"
    ],
    "start_time_of_day": "string",
    "end_time_of_day": "string"
  },
  "price_modifiers": [
    {
      "uid": "string",
      "value": 0,
      "type": "string",
      "vat": 0,
      "tariff_dimension_types": [
        "string"
      ]
    }
  ],
  "grace_period_notification_seconds": 0,
  "elements": [
    {
      "uid": "string",
      "price_components": [
        {
          "type": "string",
          "price": 0,
          "vat": 0,
          "step_size": "string"
        }
      ],
      "restrictions": {
        "start_time": "string",
        "end_time": "string",
        "start_date": "string",
        "end_date": "string",
        "min_kwh": 0,
        "max_kwh": 0,
        "min_current": 0,
        "max_current": 0,
        "min_power": 0,
        "max_power": 0,
        "min_duration": "string",
        "max_duration": "string",
        "day_of_week": [
          "string"
        ],
        "reservation": "string",
        "max_average_power": 0,
        "reservation_min_kwh": 0,
        "reservation_max_kwh": 0,
        "advance_booking_days_min": "string",
        "advance_booking_days_max": "string"
      },
      "session_stage": "string"
    }
  ],
  "tariff_alt_text": [
    {
      "language": "string",
      "text": "string"
    }
  ],
  "tariff_alt_url": "string",
  "max_price_threshold": 0,
  "min_delta_wh_threshold": 0,
  "consecutive_delta_below_threshold_to_stop": 0,
  "time_threshold_to_stop_seconds": 0,
  "price_platform_flat": {
    "excl_vat": 0,
    "incl_vat": 0
  },
  "entity_code": "string",
  "last_updated": "string"
}