Tariff

idstringtari[A-Z\d]{26}read-onlyrequired

Unique identifier for the given user.

Example:"tari01HN2NJ9NMRZBXT1H6FT9N7735"

urlstring, (uri)required

Example:"https://api.ev.energy/v2/tariffs/tari01HN2NJ9NMRZBXT1H6FT9N7735"

supplierstring or Supplier (object)required

One of:

The energy company that supplies this tariff.

string (uri)

namestringrequired

Example:"Fangorn Biomass"

currencystringrequired

Example:"GBP"

highlightedboolean

A highlighted tariff is one that is often selected by users.

typeany

Enum:"FLAT_RATE""DUAL_RATE""THREE_RATE""DYNAMIC""EXTERNALLY_MANAGED""OTHER"

daily_pricesobject, [ 1 .. 3 ] properties(DailyPrices)

The times returned here are localised to the timezone the tariff is in. The timezone is returned in timezone_name.

timezone_namestring

Example:"Europe/London"

price_chart_urlstring or null

The url of a website which can display a chart of prices for the tariff. This website is an external resource and is not affiliated with ev.energy.

Example:"https://www.example.com/"

gsp_groupstring or null

The GB Grid Supply Point (DNO region) the tariff applies to. Suppliers publish region-specific rates, so the same named tariff can appear once per region with differing prices; this field distinguishes them. null for tariffs that are not region-specific.

Example:"_C"

valid_fromstring, (date)

The date from which this tariff became available to new customers.

Example:"2026-03-17"

valid_untilstring or null, (date)

The date after which this tariff is no longer available to new customers (it has been superseded). null if the tariff is still open to new sign-ups. Use the valid query parameter to filter the list to only currently-available tariffs.

Example:"2027-03-17"

scheduler_tariffstring or object or null

One of:

The tariff used by the scheduler for charge optimisation, which may differ from the billing tariff. Returns a URL by default, or null if not set. Expandable with ?expand=scheduler_tariff to return a TariffBase object (additional fields may be present beyond those listed here).

string (uri)

{
  "id": "tari01HN2NJ9NMRZBXT1H6FT9N7735",
  "url": "https://api.ev.energy/v2/tariffs/tari01HN2NJ9NMRZBXT1H6FT9N7735",
  "supplier": "https://api.ev.energy/v2/suppliers/supl01HN2NJ9NMRZBXT1H6FT9N7735",
  "name": "Fangorn Biomass",
  "currency": "GBP",
  "gsp_group": "_C",
  "valid_from": "2026-03-17",
  "valid_until": "2027-03-17",
  "daily_prices": {
    "peak": { … },
    "mid_peak": { … },
    "off_peak": { … }
  },
  "scheduler_tariff": "https://api.ev.energy/v2/tariffs/tari01HN2NJ9NMRZBXT1H6FT9N7835"
}