GET
/
slots
/
time
/
{id}
curl --request GET \
  --url https://api.flatpeak.com/slots/time/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "sta_65e42cdd73e9f861edda35d7",
  "object": "slot_time",
  "live_mode": true,
  "location_id": "loc_65e42ce4d3b813479b252160",
  "location_timezone": "Europe/London",
  "currency_code": "EUR",
  "direction": "IMPORT",
  "next_update": "2023-06-18T23:00:00Z",
  "request": {
    "direction": "IMPORT",
    "segment": "LOW",
    "duration": 60,
    "start_time": "2022-05-24T14:15:22Z",
    "end_time": "2022-05-24T16:15:22Z"
  },
  "data": [
    {
      "start_time": "2024-05-20T00:00:00Z",
      "end_time": "2024-05-20T05:30:00Z",
      "tariff": {
        "rate_avg": 3.221,
        "confidence": 1
      }
    }
  ],
  "time_created": "2024-05-23T15:14:22Z",
  "account_id": "acc_661677911f2197045e6cf1b1"
}

Authorizations

Authorization
string
header
required

Authenticate with bearer_token you obtained from /login endpoint.

Path Parameters

id
string
required

FlatPeak Location ID

Query Parameters

start_time
string

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; if time offsets differ end_time takes priority.

Example:

"2023-06-15T09:00:00Z"

end_time
string
required

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; if time offsets differ end_time takes priority. The maximum period between start_time and end_time for a single request is 90 days.

Example:

"2023-06-15T23:00:00Z"

direction
string
default:IMPORT

Indicates direction you want to work with. Set to IMPORT or EXPORT. Defaults to IMPORT.

Example:

"IMPORT"

segment
string
required

Set to HIGH to get most expensive rate segment and to LOW to get cheapest segment.

Example:

"LOW"

duration
number
required

Amount of time in minutes you need with lowest or highest (set segment=HIGH/LOW) tariff over requested period.

Response

200
application/json

Example response

This object is a container for tariff slots response.