Tariff summary - Flatpeak

This page lists the user’s connected tariffs, where the user can view details, report an error or disconnect. It is the last step of a connection, and a returning user with tariffs lands here when a session starts. The pricing schedule shows as a chart, which the user can switch to a table.

Overview
Settings
Pending Error Report
Fallback Tariff
Code

{
  "connect_session": "cos_6587fa4362341be5b524de3b",
  "route": "tariffs_summary",
  "live_mode": true,
  "actions": [
    "DISCONNECT",
    "REPORT_ERROR",
    "UPDATE_REPORT",
    "CANCEL_REPORT",
    "CLOSE",
    "BACK"
  ],
  "data": {
    "device_type": "BATTERY_STORAGE",
    "time_updated": "2026-06-24T23:10:00+01:00",
    "location": {
      "timezone": "Europe/London",
      "currency_code": "GBP"
    },
    "tariffs": [
      {
        "tariff_type": "COMMODITY",
        "direction": "IMPORT",
        "status": "CONNECTED",
        "tariff_id": "trf_66ba584eb6923d7c3b942ef6",
        "connection_type": "DIRECT",
        "market_index_source": true,
        "display_name": "Agile Octopus v3 2024",
        "fallback": false,
        "vat": 0.19,
        "supplier": {
          "id": "sup_63a6087272921ef075a8fd3e",
          "display_name": "Octopus Energy",
          "logo_url": "https://s.flatpeak.com/83b06a60e38c2.png"
        },
        "prices": {
          "yesterday": [],
          "today": [
            {
              "start_time": "2026-02-01T00:00:00Z",
              "end_time": "2026-02-01T22:00:00Z",
              "price": {
                "value": 0.12,
                "confidence": 1
              }
            }
          ],
          "tomorrow": [
            {
              "start_time": "2026-02-02T00:00:00Z",
              "end_time": "2026-02-02T06:00:00Z",
              "price": {
                "value": 0.09,
                "confidence": 1
              }
            }
          ]
        }
      },
      {
        "tariff_type": "NON_COMMODITY",
        "direction": "IMPORT",
        "device_id": "dev_9c1f70a4e2b6485db3f0c8a1",
        "status": "CONNECTED",
        "tariff_id": "trf_66fa584eb6923d7c3b942ef8",
        "connection_type": "LIBRARY",
        "display_name": "Effektabonnemang 16 to 25 A",
        "fallback": false,
        "vat": 0,
        "supplier": {
          "id": "sup_63a6087272921ef075a8fd3e",
          "display_name": "Sollentuna Elnät AB",
          "logo_url": "https://s.flatpeak.com/83b06a60e38c2.png"
        },
        "prices": {
          "yesterday": [],
          "today": [
            {
              "start_time": "2026-02-01T00:00:00Z",
              "end_time": "2026-02-01T22:00:00Z",
              "price": {
                "value": 0.6,
                "confidence": 1
              }
            }
          ],
          "tomorrow": [
            {
              "start_time": "2026-02-02T00:00:00Z",
              "end_time": "2026-02-02T06:00:00Z",
              "price": {
                "value": 0.6,
                "confidence": 1
              }
            }
          ]
        }
      }
    ]
  }
}

curl --request POST \
  --url https://connect.flatpeak.com \
  --header 'Content-Type: application/json' \
  --data '{
  "connect_session": "cos_6587fa4362341be5b524de3b",
  "route": "tariffs_summary",
  "action": "REPORT_ERROR",
  "action_context": "commodity_import"
}'

The `data` object

Field	Description
`time_updated`	When the price schedule was last refreshed, RFC 3339 with offset. Show it with the schedule, for example “Updated 24 Jun - 23:10”.
`tariffs[].device_id`	Present on a device tariff only. It applies to the session’s device and replaces the location tariff of the same `tariff_type` and `direction`, which is then not listed. Label the two differently, for example “Heat pump tariff” and “Home tariff”.

Tariff statuses

Status	Description
`CONNECTED`	The tariff is connected and live.
`NOT_CONNECTED`	No tariff is connected. Prompt the user to connect one.
`ERROR_REPORTED`	The user reported an error.
`ERROR`	The tariff could not be retrieved. The supplier connection may be down. Prompt the user to disconnect and connect again, or to contact support if it continues.
`EXPIRED`	The connection has expired and retrieves no data. The user must reconnect.
`UPGRADE`	A better connection is available, usually a direct integration. The tariff stays live until the user reconnects through Connect.

Actions

Action	Result
`DISCONNECT`	Disconnects the tariff and completes the session.
`REPORT_ERROR`	Reports an incorrect tariff to Flatpeak. Not offered once reported.
`UPDATE_REPORT`	Adds details to an open error report. Offered while the status is `ERROR_REPORTED`.
`CANCEL_REPORT`	Withdraws an open error report. Offered while the status is `ERROR_REPORTED`.
`BACK`	Returns the previous page.
`CLOSE`	Returns the `callback_url` set on the Connect session.

action_context names the tariff the action applies to: commodity_import, commodity_export or non_commodity_import.There is no reconnect action: send DISCONNECT, then start the connection flow again.

Errors

Error code	Description
`action_missing`	Action parameter is required.
`action_invalid`	Action parameter XX is not supported.
`data_json_invalid`	Data does not conform to the JSON schema.