List tariffs

Authorizations

Authorization

string

header

required

Authenticate with bearer_token you obtained from /login endpoint.

Query Parameters

direction

any

Filter by tariff direction, supported values are IMPORT and EXPORT.

type

string

Filter by tariff type, supported values are COMMODITY and NON_COMMODITY.

location_id

string

required

Filter by FlatPeak Location ID.

starting_after

string

Specifies a cursor for pagination use; provider_id defines the place in the list. To retrieve the next page in the list include starting_after where ID is the last ID in the currently retrieved list.

ending_before

string

Specifies a cursor for pagination use; provider_id defines the place in the list. To retrieve the previous page in the list include ending_before where is the first ID in the currently retrieved list.

limit

integer

A limit on the number of objects to be returned. Can range between 1 and 100, and the default is 30.

Response

200 - application/json

has_more

boolean

default:

false

required

Is set to true if more objects are available.

object

string

required

Represents the object’s type. i.e. list.

url

string

required

Represents url slug for the object.

data

object[]

data.account_id

string

required

FlatPeak account ID.

data.connection_type

string

required

Represents tariff connection type. Set automatically by FlatPeak depending on how tariff was created.

data.contract_end_date

string

required

Indicates end date of the energy supply contract between customer and provider.

data.contract_start_date

string

required

Indicates start date of the energy supply contract between customer and provider.

data.direction

string

required

Indicates direction of energy transfer this tariff applies to. Supported options are IMPORT, EXPORT or LOCAL. LOCAL direction is in beta. Contact support to enable.

data.id

string

required

Unique tariff element ID.

data.is_linked

boolean

default:

false

required

This indicates that the tariff is linked to an external data source and is automatically updated from this source. Such as when it's linked to your customer's provider account or to a tariff in the FlatPeak tariffs library. This value is set automatically by FlatPeak and cannot be changed.

data.live_mode

boolean

required

Has the value true if the object exists in live mode or the value false if the object exists in test mode.

data.location_id

string

required

FlatPeak Location ID this tariff element is associated with.

data.market_rates

boolean

default:

false

required

Indicates if this tariff is based on a market rate.

data.object

string

required

FlatPeak object type. I.e. tariff_element.

data.status

string

required

Status of tariff element. Possible values are CONNECTED or ERROR.

data.time_created

string

required

Indicates time when this tariff object was created.

data.timezone

string

required

The timezone at the location, in 'tz database format'. I.e. 'Europe/Berlin'.

data.type

string

required

Indicates tariff type you want to work with. Set to COMMODITY or NON_COMMODITY.

data.display_name

string

Tariff display name.

data.provider_id

string

FlatPeak ID of the provider this tariff belongs to.

data.schedule

object[]

Tariff schedule object.

Service objects

Reporting

Planning

Authorizations

Query Parameters

Response