List Tariffs

GET /v3/tariffs

List Tariffs

cURL

curl --request GET \
  --url https://app.plugchoice.com/api/v3/tariffs \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "type": "<string>",
      "location": "<string>",
      "timestamp": "<string>",
      "price": 123,
      "price_includes_tax": true
    }
  ]
}

Returns a list of energy tariffs for a specific location. Only tariffs from today onwards are returned.

location · string · required

The location identifier to retrieve tariffs for.

Response

data · array

Array of tariff objects.

Show tariff

type · string

The tariff type.

location · string

The location identifier.

timestamp · string

ISO 8601 timestamp of when the tariff rate applies.

price · number

The energy price.

price_includes_tax · boolean

Whether the price includes tax.