POST
/
tariffs
/
elements

Authorizations

Authorization
string
header
required

Authenticate with bearer_token you obtained from /login endpoint.

Body

application/json
contract_end_date
string
required

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

contract_start_date
string
required

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

direction
string
required

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

location_id
string
required

FlatPeak Location ID this tariff element will be associated with.

type
string
required

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

display_name
string

Tariff display name.

market_rates
boolean
default:
false

Indicates if this tariff is based on a market rate.

provider_id
string

FlatPeak ID of the provider this tariff belongs to.

schedule
object[]

Tariff schedule object.

Response

200 - application/json
account_id
string
required

FlatPeak account ID.

connection_type
string
required

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

contract_end_date
string
required

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

contract_start_date
string
required

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

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.

id
string
required

Unique tariff element ID.

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.

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.

location_id
string
required

FlatPeak Location ID this tariff element is associated with.

market_rates
boolean
default:
false
required

Indicates if this tariff is based on a market rate.

object
string
required

FlatPeak object type. I.e. tariff_element.

status
string
required

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

time_created
string
required

Indicates time when this tariff object was created.

timezone
string
required

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

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.

schedule
object[]

Tariff schedule object.