POST
/
tariffs
/
elements

Authorizations

Authorization
string
headerrequired

Authenticate with bearer_token you obtained from /login endpoint.

Body

application/json
location_id
string
required

FlatPeak Location ID this tariff element will be associated with.

direction
string
required

Indicates direction of energy transfer this tariff applies to. Supported options are IMPORT, EXPORT or LOCAL.

type
string
required

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

display_name
string

Tariff display name.

provider_id
string

FlatPeak ID of the provider this tariff belongs to.

market_rates
boolean
default: false

Indicates if this tariff is based on a market rate.

contract_start_date
string
required

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

contract_end_date
string
required

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

schedule
object[]

Tariff schedule object.

Response

200 - application/json
id
string
required

Unique tariff element ID.

object
string
required

FlatPeak object type. I.e. tariff_element.

location_id
string
required

FlatPeak Location ID this tariff element is associated with.

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.

is_linked
boolean
default: falserequired

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.

connection_type
string
required

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

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.

type
string
required

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

status
string
required

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

timezone
string
required

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

display_name
string

Tariff display name.

provider_id
string

FlatPeak ID of the provider this tariff belongs to.

market_rates
boolean
default: falserequired

Indicates if this tariff is based on a market rate.

contract_start_date
string
required

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

contract_end_date
string
required

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

schedule
object[]

Tariff schedule object.

time_created
string
required

Indicates time when this tariff object was created.

account_id
string
required

FlatPeak account ID.