Query station tariff list

To get an overview of the charging costs and optional setup fee you can run the query station tariff list. Within this list you will find all costs per station.

Query

The tariffList query works out of the box and no additional information is required. However, you have the option to enable pagination on the query to improve the performance as you can see below.

Arguments

size • scalar • Int

The number of element (count) to return, default: 10

page • scalar • Int

Page number to return, default: 0

Frequently used fields

currency • scalar • String

ISO-4217 code of the currency of this tariff.

min_price • object • OCPIPrice

When this field is set, a charging session with this tariff will cost at least the amount shown. This is different from a FLAT fee (start tariff, transaction fee), as a FLAT fee is a fixed amount that must be paid for any charging session. A minimum price indicates that when the cost of a charging session is lower than this amount, the cost of the session will be equal to this amount

max_price • object • OCPIPrice

When this field is set, a charging session with this tariff will NOT cost more than this amount

elements • list • OCPITariffElement

List of tariff elements

price_components • list • OCPIPriceComponent

List of price components that describe the pricing of a tariff.

restrictions • list • OCPITariffRestrictions

Restrictions that describe the applicability of a tariff.

start_time • scalar • String

Start time of day in local time, the time zone is defined in the time_zone field of the Location, for example 13:30, valid from this time of the day. Must be in 24h format with leading zeros. Hour/Minute separator: ":" Regex: ([0-1][0-9]|2[1-3]):[0-5][0-9]

end_time • scalar • String

End time of day in local time, the time zone is defined in the time_zone field of the Location, for example 19:45, valid until this time of the day. Same syntax as start_time.

start_date • scalar • String

Start date in local time, the time zone is defined in the time_zone field of the Location, for example: 2015-12-24, valid from this day. Regex: ([12][0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])

end_date • scalar • String

End date in local time, the time zone is defined in the time_zone field of the Location, for example: 2015-12-27, valid until this day (exclusive). Same syntax as start_date

min_kwh • scalar • Float

Minimum consumed energy in kWh, for example 20, valid from this amount of energy being used

max_kwh • scalar • Float

Maximum consumed energy in kWh, for example 50, valid until this amount of energy being used

min_current • scalar • Float

Sum of the minimum current in over all phases, for example 5. When the EV is charging with more than the defined amount of current, this tariff element is/becomes active. If the charging current is or becomes lower, this tariff element is not or no longer valid and becomes inactive. This does not describe the minimum current over the entire charging session. This restriction can make a tariff element become active when the charging current is above the defined value, but the tariff element MUST no longer be active when the charging current drops below the defined value

max_current • scalar • Float

Sum of the maximum current in over all phases, for example 20. When the EV is charging with less than the defined amount of current, this tariff element becomes/is active. If the charging current is or becomes higher, this tariff element is not or no longer valid and becomes inactive. This describes NOT the maximum current over the entire Charging Session. This restriction can make a tariff element become active when the charging current is below this value, but the tariff element MUST no longer be active when the charging current raises above the defined value

min_power • scalar • Float

Minimum power in kW, for example 5. When the EV is charging with more than the defined amount of power, this tariff element is/becomes active. If the charging power is or becomes lower, this tariff element is not or no longer valid and becomes inactive. This does not describe the minimum power over the entire charging session. This restriction can make a tariff element become active when the charging power is above this value, but the TariffElement MUST no longer be active when the charging power drops below the defined value

max_power • scalar • Float

Maximum power in kW, for example 20. When the EV is charging with less than the defined amount of power, this tariff element becomes/is active. If the charging power is or becomes higher, this tariff element is not or no longer valid and becomes inactive. This does not describe the maximum power over the entire charging session. This restriction can make a tariff element become active when the charging power is below this value, but the TariffElement MUST no longer be active when the charging power raises above the defined value

min_duration • scalar • Float

Minimum duration in seconds the charging session MUST last (inclusive). When the duration of a charging session is longer than the defined value, this TariffElement is or becomes active. Before that moment, this tariff element is not yet active

max_duration • scalar • Float

Maximum duration in seconds the charging session MUST last (exclusive). When the duration of a charging session is shorter than the defined value, this tariff element is or becomes active. After that moment, this tariff element is no longer active

day_of_week • enum • OCPIDayOfWeek

Which day(s) of the week this tariff element is active.

reservation • enum • OCPIReservationRestrictionType

When this field is present, the tariff element describes reservation costs. A reservation starts when the reservation is made, and ends when the drivers starts charging on the reserved EVSE/Location, or when the reservation expires. A reservation can only have: FLAT and TIME TariffDimensions, where TIME is for the duration of the reservation

Other fields

country_code • scalar • String

ISO-3166 alpha-2 country code of the CPO that owns this tariff

party_id • scalar • String

CPO ID of the CPO that owns this tariff (following the ISO-15118 standard)

id • scalar • String

Uniquely identifies the tariff within the CPO’s platform (and suboperator platforms)

currency • scalar • String

ISO-4217 code of the currency of this tariff.

type • enum • OCPITariffType

Defines the type of the tariff. This allows for distinction in case of given charging preferences. When omitted, this tariff is valid for all sessions

tariff_alt_text • list • OCPIDisplayText

List of alternative tariff information texts, in multiple languages

tariff_alt_url • scalar • String

URL to a web page that contains an explanation of the tariff information in human readable form

min_price • object • OCPIPrice

max_price • object • OCPIPrice

When this field is set, a charging session with this tariff will NOT cost more than this amount

elements • list • OCPITariffElement

List of tariff elements

price_components • list • OCPIPriceComponent

List of price components that describe the pricing of a tariff.

restrictions • list • OCPITariffRestrictions

Restrictions that describe the applicability of a tariff.

start_time • scalar • String

end_time • scalar • String

End time of day in local time, the time zone is defined in the time_zone field of the Location, for example 19:45, valid until this time of the day. Same syntax as start_time.

start_date • scalar • String

Start date in local time, the time zone is defined in the time_zone field of the Location, for example: 2015-12-24, valid from this day. Regex: ([12][0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])

end_date • scalar • String

End date in local time, the time zone is defined in the time_zone field of the Location, for example: 2015-12-27, valid until this day (exclusive). Same syntax as start_date

min_kwh • scalar • Float

Minimum consumed energy in kWh, for example 20, valid from this amount of energy being used

max_kwh • scalar • Float

Maximum consumed energy in kWh, for example 50, valid until this amount of energy being used

min_current • scalar • Float

max_current • scalar • Float

min_power • scalar • Float

max_power • scalar • Float

min_duration • scalar • Float

max_duration • scalar • Float

day_of_week • enum • OCPIDayOfWeek

Which day(s) of the week this tariff element is active.

reservation • enum • OCPIReservationRestrictionType

start_date_time • scalar • DateTime

Time when this tariff becomes active, in UTC, time_zone field of the Location can be used to convert to local time. Typically used for a new tariff that is already given with the location, before it becomes active

end_date_time • scalar • DateTime

Time after which this tariff is no longer valid, in UTC, time_zone field if the location can be used to convert to local time. Typically used when this tariff is going to be replaced with a different tariff in the near future

energy_mix • object • OCPIEnergyMix

Details about the energy supplied with this tariff

last_updated • scalar • DateTime

Timestamp when this tariff was last updated (or created)

Response

If successful, the HTTP status code in the response header is 200 and the response body contains the attributes you requested.

If unsuccessful, the header status code is an error code and the response body contains an error response object. The error response object can be any of the ones below.

Errors and warnings

Error

ERROR_FORBIDDEN_MESSAGE

You are forbidden to execute this operation

Error

PAGINATION_INVALID_PAGE

Page must be an INT value higher than 0

Error

PAGINATION_INVALID_SIZE

Size must be an INT value between 1 and 1000

Request

          query tariffList {  tariffList (    size: 5,     page: 1  ) {    id    country_code    party_id    id    currency    type    tariff_alt_url    tariff_alt_text {      text    }    min_price {      incl_vat    }    max_price {      incl_vat    }    elements {      price_components {        price        vat      }      restrictions {        day_of_week      }    }    start_date_time    end_date_time    energy_mix {      is_green_energy    }    last_updated  }}

Playground

Response

          {  data: {    tariffList: [      {        id: "#",        country_code: null,        party_id: null,        currency: "EUR",        type: null,        tariff_alt_url: "",        tariff_alt_text: [          {            text: "PNB",          },        ],        min_price: null,        max_price: null,        elements: [          {            price_components: [              {                price: 0.5,                vat: 0,              },            ],            restrictions: [],          },          {            price_components: [              {                price: 0.29,                vat: 0,              },            ],            restrictions: [              {                day_of_week: null,              },            ],          },        ],        start_date_time: null,        end_date_time: null,        energy_mix: null,        last_updated: "2018-09-25T23:10:04.000Z",      },    ],  },}