> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tariff summary

> Connect page that lists the user's connected tariffs, their status and the actions on each.

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.

> [tab] Overview
>
> ![](https://mintcdn.com/flatpeak-d495c19e/2B6nWUU4-c2pSD3E/images/busbar/connect/summary-dark.png?fit=max\&auto=format\&n=2B6nWUU4-c2pSD3E\&q=85\&s=f133a194efa0490083ea0051e361d65a)

> [tab] Settings
>
> The manage sheet: report an error or disconnect.
>
> ![](https://mintcdn.com/flatpeak-d495c19e/2B6nWUU4-c2pSD3E/images/busbar/connect/summary-tariff-settings.png?fit=max\&auto=format\&n=2B6nWUU4-c2pSD3E\&q=85\&s=260e5a23697c7ad13dd703116593d532)

> [tab] Pending Error Report
>
> Shown while an error report is open. The user can add details or withdraw it.
>
> ![](https://mintcdn.com/flatpeak-d495c19e/2B6nWUU4-c2pSD3E/images/busbar/connect/summary-error-report-pending.png?fit=max\&auto=format\&n=2B6nWUU4-c2pSD3E\&q=85\&s=c3558f4fe304f5a058183f0d4f477663)

> [tab] Fallback Tariff
>
> Shown when the user set a [fallback tariff](/docs/energy-api/reference/connect/tariff/prices.md#the-fallback_tariff-field). Flatpeak resolves the real tariff in the background and applies it.
>
> ![](https://mintcdn.com/flatpeak-d495c19e/2B6nWUU4-c2pSD3E/images/busbar/connect/summary-fallback-tariff.png?fit=max\&auto=format\&n=2B6nWUU4-c2pSD3E\&q=85\&s=645d430726b68a9a682574251f0f3dcd)

> [tab] Code
>
> ```json Connect response theme={"system"}
> {
>   "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
>               }
>             }
>           ]
>         }
>       }
>     ]
>   }
> }
> ```
>
> ```bash Your POST to Connect (action) theme={"system"}
> 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](/docs/energy-api/guides/key-concepts.md#device-tariffs) 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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.