Get usage slots by tariff level threshold
Returns time slots were tariff rate is below or above target level, by Location ID.
Useful when you need to provide, say, 5 hours of charging time between 9pm and 6am when price is lowest.
Authorizations
Authenticate with bearer_token you obtained from /login endpoint.
Path Parameters
FlatPeak Location ID
Query Parameters
Time when data will start must be in RFC3339 format, e.g., 2023-06-15T09:00:00Z or with time offset, e.g., 2023-06-15T08:00:00+01:00. Use either Zulu time (UTC) or time offset; mixed values are not allowed.
Time when data will end, in RFC3339 format, e.g. 2023-06-15T13:00:00Z or with time offset, e.g. 2023-06-15T12:00:00+01:00. Use either Zulu time (UTC) or time offset; mixed values are not allowed. The maximum period between start_time and end_time for a single request is 90 days.
Indicates direction you want to work with. Set to IMPORT or EXPORT. Defaults to IMPORT.
Set to HIGH to get most expensive rate segment and to LOW to get cheapest segment.
Relative tariff threshold. Highest tariff is 1 and lowest is 0.01. Either relative or absolute must be provided.
Absolute tariff threshold in local currency. Either absolute or relative must be provided. Absolute threshold overrides relative if it was provided.
Response
This object is a container for tariff rates segments.
FlatPeak unique object id.
Represents the object's type.
Has the value true if the object exists in live mode or the value false if the object exists in test mode.
The unique FlatPeak ID of the location.
The timezone at the location, in 'tz database format'. I.e. 'Europe/Berlin'.
Currency at the location in ISO 4217.
Direction of tariff. Supported options are IMPORT and EXPORT.
Time when we recommend fetching new rates. In format of the request, e.g. UTC or time-offset.
Your original request.
Rates response data.
Time when this response was calculated. In UTC.
FlatPeak account ID.
Was this page helpful?