# Octopus Energy

> Octopus Energy's public tariffs and prices for Great Britain: Agile Octopus's half-hourly electricity prices, the cheapest times to use electricity, unit rates and standing charges for electricity and gas on any of its products in each region, and the region for a postcode. No account or API key needed.

App · 8 actions. Web page: https://docs.lodol.com/docs/integrations/octopus-energy

## Actions

### Find cheapest electricity times

Find the cheapest time to use electricity for a number of hours, such as to charge a car or run a dishwasher: the cheapest block in a row, or the cheapest half hours wherever they fall, from Agile Octopus prices by default.

**Inputs**

- Region (`region`, text, required): Your electricity region: prices differ between Great Britain's 14 regions. Find region for postcode looks yours up. One of: `A` (Eastern England (A)), `B` (East Midlands (B)), `C` (London (C)), `D` (Merseyside and North Wales (D)), `E` (West Midlands (E)), `F` (North East England (F)), `G` (North West England (G)), `H` (Southern England (H)), `J` (South East England (J)), `K` (South Wales (K)), and 4 more.
- Product (`product_code`, text): The Octopus product. Leave empty for Agile Octopus, whose prices change every half hour; or pick or type another, such as Octopus Go.
- Hours needed (`hours`, number): How long you need electricity for, in half hours (such as 2 or 1.5). Defaults to 1. From 0.5 to 24.0.
- In a row (`consecutive`, true/false): Find one unbroken block of time. Turn off to take the cheapest half hours wherever they fall. Default: `true`.
- Search from (`period_from`, date and time): The earliest time to start. Leave empty for now.
- Finish by (`period_to`, date and time): The time to be done by. Leave empty to search every price published from the start (Agile is published up to a day and a half ahead).

**Outputs**

- `average_exc_vat` (number): The same average excluding VAT.
- `average_inc_vat` (number): The average unit rate of the chosen half hours, pence per kWh including VAT.
- `consecutive` (true/false): True when the half hours had to be in a row.
- `end` (text): When the last chosen half hour ends, ISO 8601 in UTC.
- `hours` (number): The hours asked for.
- `prices_known_until` (text): The end of the last half hour with a published price in the window: later times could not be considered yet.
- `product_code` (text): The product searched, such as AGILE-24-10-01.
- `product_name` (text): Its name, such as Agile Octopus.
- `region` (text): The region's letter, A to P.
- `region_name` (text): The region's name, such as London.
- `searched_from` (text): The start of the window searched, ISO 8601 in UTC.
- `searched_to` (text): The end of the window searched, ISO 8601 in UTC.
- `slot_count` (number): How many half hours were chosen.
- `slots` (list): The chosen half hours, earliest first.
- `start` (text): When the first chosen half hour starts, ISO 8601 in UTC.
- `tariff_code` (text): The tariff searched, such as E-1R-AGILE-24-10-01-C.
- `uk_time` (text): From start to end on the UK clock, such as 01:00 to 03:00 BST on Thu 22 Oct 2026.

**Example output**

```json
{
  "average_exc_vat": 9.395,
  "average_inc_vat": 9.8648,
  "consecutive": true,
  "end": "2026-09-01T12:00:00Z",
  "hours": 1.0,
  "prices_known_until": "2026-09-02T00:00:00Z",
  "product_code": "AGILE-24-10-01",
  "product_name": "Agile Octopus",
  "region": "C",
  "region_name": "London",
  "searched_from": "2026-09-01T00:00:00Z",
  "searched_to": "2026-09-02T00:00:00Z",
  "slot_count": 2,
  "slots": [
    {
      "uk_time": "12:00 to 12:30 BST on Tue 1 Sep 2026",
      "valid_from": "2026-09-01T11:00:00Z",
      "valid_to": "2026-09-01T11:30:00Z",
      "value_exc_vat": 9.66,
      "value_inc_vat": 10.143
    },
    {
      "uk_time": "12:30 to 13:00 BST on Tue 1 Sep 2026",
      "valid_from": "2026-09-01T11:30:00Z",
      "valid_to": "2026-09-01T12:00:00Z",
      "value_exc_vat": 9.13,
      "value_inc_vat": 9.5865
    }
  ],
  "start": "2026-09-01T11:00:00Z",
  "tariff_code": "E-1R-AGILE-24-10-01-C",
  "uk_time": "12:00 to 13:00 BST on Tue 1 Sep 2026"
}
```

### Find region for postcode

Find which of Great Britain's 14 electricity regions a postcode is in. Prices differ by region, and the other actions take its letter.

**Inputs**

- Postcode (`postcode`, text, required): A full postcode in Great Britain.

**Outputs**

- `count` (number): How many regions the postcode is in.
- `postcode` (text): The postcode looked up, tidied, such as SW1A 1AA.
- `region` (text): The region's letter, A to P, to use in the other actions. Empty when the postcode spans two regions: regions lists both.
- `region_name` (text): The region's name, such as London.
- `regions` (list): Every region the postcode is in (almost always one).

**Example output**

```json
{
  "count": 1,
  "postcode": "SW1A 1AA",
  "region": "C",
  "region_name": "London",
  "regions": [
    {
      "region": "C",
      "region_name": "London"
    }
  ]
}
```

### Get electricity standing charges

Get the daily electricity standing charge of an Octopus tariff over a period, earliest first, with the one in force now, for a single-rate or a day and night meter.

**Inputs**

- Product (`product_code`, text, required): The Octopus product (tariff family). Pick one on sale now, or type any product code, such as VAR-22-11-01, from List products or a bill.
- Region (`region`, text, required): Your electricity region: prices differ between Great Britain's 14 regions. Find region for postcode looks yours up. One of: `A` (Eastern England (A)), `B` (East Midlands (B)), `C` (London (C)), `D` (Merseyside and North Wales (D)), `E` (West Midlands (E)), `F` (North East England (F)), `G` (North West England (G)), `H` (Southern England (H)), `J` (South East England (J)), `K` (South Wales (K)), and 4 more.
- Meter (`meter`, text): The kind of electricity meter: a day and night (Economy 7) meter has its own standing charge. One of: `single` (Single-rate meter), `day_night` (Day and night meter (Economy 7)). Default: `single`.
- From (`period_from`, date and time): The start of the period to list prices for. Leave empty for midnight today, UK time.
- Until (`period_to`, date and time): The end of the period. Leave empty for every price published from the start, which for Agile runs to 11pm tomorrow once tomorrow's prices are out.
- Paying by (`payment_method`, text): Variable tariffs cost more when not paid by Direct Debit. Prices that are the same either way are always listed. One of: `DIRECT_DEBIT` (Direct Debit), `NON_DIRECT_DEBIT` (Not by Direct Debit). Default: `DIRECT_DEBIT`.

**Outputs**

- `count` (number): How many standing charges are listed.
- `current` (object): The standing charge in force right now, or empty if the period is not now.
- `has_more` (true/false): True when the period holds more than one request returns (1,500 prices); only the latest are listed. Shorten the period to see the rest.
- `meter` (text): The kind of meter: single or day_night.
- `period_from` (text): The start of the period listed, ISO 8601 in UTC.
- `period_to` (text): The end of the period listed; empty for everything published since the start.
- `product_code` (text): The product the prices are for, such as AGILE-24-10-01.
- `product_name` (text): The product's name, such as Agile Octopus.
- `rates` (list): The standing charges, earliest first.
- `region` (text): The region's letter, A to P.
- `region_name` (text): The region's name, such as London.
- `tariff_code` (text): The tariff the prices are for, such as E-1R-AGILE-24-10-01-C.

**Example output**

```json
{
  "count": 1,
  "current": {
    "payment_method": "DIRECT_DEBIT",
    "uk_time": "From 00:00 BST on Thu 1 Oct 2026",
    "valid_from": "2026-09-30T23:00:00Z",
    "valid_to": null,
    "value_exc_vat": 41.3869,
    "value_inc_vat": 41.3869
  },
  "has_more": false,
  "meter": "single",
  "period_from": "2026-10-20T23:00:00Z",
  "period_to": null,
  "product_code": "VAR-22-11-01",
  "product_name": "Flexible Octopus",
  "rates": [
    {
      "payment_method": "DIRECT_DEBIT",
      "uk_time": "From 00:00 BST on Thu 1 Oct 2026",
      "valid_from": "2026-09-30T23:00:00Z",
      "valid_to": null,
      "value_exc_vat": 41.3869,
      "value_inc_vat": 41.3869
    }
  ],
  "region": "C",
  "region_name": "London",
  "tariff_code": "E-1R-VAR-22-11-01-C"
}
```

### Get electricity unit rates

Get the price per kWh of electricity on an Octopus tariff over a period, earliest first, with the current, lowest and highest: Agile Octopus's half-hourly prices by default, or any product's standard, day, night or EV charging rates.

**Inputs**

- Region (`region`, text, required): Your electricity region: prices differ between Great Britain's 14 regions. Find region for postcode looks yours up. One of: `A` (Eastern England (A)), `B` (East Midlands (B)), `C` (London (C)), `D` (Merseyside and North Wales (D)), `E` (West Midlands (E)), `F` (North East England (F)), `G` (North West England (G)), `H` (Southern England (H)), `J` (South East England (J)), `K` (South Wales (K)), and 4 more.
- Product (`product_code`, text): The Octopus product. Leave empty for Agile Octopus, whose prices change every half hour; or pick or type another, such as Octopus Go.
- Rate (`rate`, text): Which unit rate: the standard one, or the day or night rate of a day and night meter, or the car charger rates of Intelligent Octopus Go. One of: `standard` (Standard unit rate (single rate, Agile, Go)), `day` (Day rate (Economy 7 and other day and night meters)), `night` (Night rate (Economy 7 and other day and night meters)), `ev_peak` (EV charger peak rate (Intelligent Octopus Go)), `ev_off_peak` (EV charger off-peak rate (Intelligent Octopus Go)). Default: `standard`.
- From (`period_from`, date and time): The start of the period to list prices for. Leave empty for midnight today, UK time.
- Until (`period_to`, date and time): The end of the period. Leave empty for every price published from the start, which for Agile runs to 11pm tomorrow once tomorrow's prices are out.
- Paying by (`payment_method`, text): Variable tariffs cost more when not paid by Direct Debit. Prices that are the same either way are always listed. One of: `DIRECT_DEBIT` (Direct Debit), `NON_DIRECT_DEBIT` (Not by Direct Debit). Default: `DIRECT_DEBIT`.

**Outputs**

- `count` (number): How many unit rates are listed.
- `current` (object): The unit rate in force right now, or empty if the period is not now.
- `has_more` (true/false): True when the period holds more than one request returns (1,500 prices); only the latest are listed. Shorten the period to see the rest.
- `highest` (object): The dearest price listed (the first, on a tie).
- `lowest` (object): The cheapest price listed (the first, on a tie).
- `period_from` (text): The start of the period listed, ISO 8601 in UTC.
- `period_to` (text): The end of the period listed; empty for everything published since the start.
- `product_code` (text): The product the prices are for, such as AGILE-24-10-01.
- `product_name` (text): The product's name, such as Agile Octopus.
- `rate` (text): Which rate: standard, day, night, ev_peak or ev_off_peak.
- `rates` (list): The unit rates, earliest first.
- `region` (text): The region's letter, A to P.
- `region_name` (text): The region's name, such as London.
- `tariff_code` (text): The tariff the prices are for, such as E-1R-AGILE-24-10-01-C.

**Example output**

```json
{
  "count": 3,
  "current": {
    "payment_method": null,
    "uk_time": "07:00 to 07:30 BST on Wed 21 Oct 2026",
    "valid_from": "2026-10-21T06:00:00Z",
    "valid_to": "2026-10-21T06:30:00Z",
    "value_exc_vat": 35.8,
    "value_inc_vat": 35.8
  },
  "has_more": false,
  "highest": {
    "payment_method": null,
    "uk_time": "18:00 to 18:30 BST on Wed 21 Oct 2026",
    "valid_from": "2026-10-21T17:00:00Z",
    "valid_to": "2026-10-21T17:30:00Z",
    "value_exc_vat": 49.81,
    "value_inc_vat": 49.81
  },
  "lowest": {
    "payment_method": null,
    "uk_time": "04:30 to 05:00 BST on Wed 21 Oct 2026",
    "valid_from": "2026-10-21T03:30:00Z",
    "valid_to": "2026-10-21T04:00:00Z",
    "value_exc_vat": 23.96,
    "value_inc_vat": 23.96
  },
  "period_from": "2026-10-20T23:00:00Z",
  "period_to": null,
  "product_code": "AGILE-24-10-01",
  "product_name": "Agile Octopus",
  "rate": "standard",
  "rates": [
    {
      "payment_method": null,
      "uk_time": "04:30 to 05:00 BST on Wed 21 Oct 2026",
      "valid_from": "2026-10-21T03:30:00Z",
      "valid_to": "2026-10-21T04:00:00Z",
      "value_exc_vat": 23.96,
      "value_inc_vat": 23.96
    },
    {
      "payment_method": null,
      "uk_time": "07:00 to 07:30 BST on Wed 21 Oct 2026",
      "valid_from": "2026-10-21T06:00:00Z",
      "valid_to": "2026-10-21T06:30:00Z",
      "value_exc_vat": 35.8,
      "value_inc_vat": 35.8
    },
    {
      "payment_method": null,
      "uk_time": "18:00 to 18:30 BST on Wed 21 Oct 2026",
      "valid_from": "2026-10-21T17:00:00Z",
      "valid_to": "2026-10-21T17:30:00Z",
      "value_exc_vat": 49.81,
      "value_inc_vat": 49.81
    }
  ],
  "region": "C",
  "region_name": "London",
  "tariff_code": "E-1R-AGILE-24-10-01-C"
}
```

### Get gas standing charges

Get the daily gas standing charge of an Octopus tariff over a period, earliest first, with the one in force now.

**Inputs**

- Product (`product_code`, text, required): The Octopus product (tariff family). Pick one on sale now, or type any product code, such as VAR-22-11-01, from List products or a bill.
- Region (`region`, text, required): Your electricity region: prices differ between Great Britain's 14 regions. Find region for postcode looks yours up. One of: `A` (Eastern England (A)), `B` (East Midlands (B)), `C` (London (C)), `D` (Merseyside and North Wales (D)), `E` (West Midlands (E)), `F` (North East England (F)), `G` (North West England (G)), `H` (Southern England (H)), `J` (South East England (J)), `K` (South Wales (K)), and 4 more.
- From (`period_from`, date and time): The start of the period to list prices for. Leave empty for midnight today, UK time.
- Until (`period_to`, date and time): The end of the period. Leave empty for every price published from the start, which for Agile runs to 11pm tomorrow once tomorrow's prices are out.
- Paying by (`payment_method`, text): Variable tariffs cost more when not paid by Direct Debit. Prices that are the same either way are always listed. One of: `DIRECT_DEBIT` (Direct Debit), `NON_DIRECT_DEBIT` (Not by Direct Debit). Default: `DIRECT_DEBIT`.

**Outputs**

- `count` (number): How many standing charges are listed.
- `current` (object): The standing charge in force right now, or empty if the period is not now.
- `has_more` (true/false): True when the period holds more than one request returns (1,500 prices); only the latest are listed. Shorten the period to see the rest.
- `period_from` (text): The start of the period listed, ISO 8601 in UTC.
- `period_to` (text): The end of the period listed; empty for everything published since the start.
- `product_code` (text): The product the prices are for, such as AGILE-24-10-01.
- `product_name` (text): The product's name, such as Agile Octopus.
- `rates` (list): The standing charges, earliest first.
- `region` (text): The region's letter, A to P.
- `region_name` (text): The region's name, such as London.
- `tariff_code` (text): The tariff the prices are for, such as E-1R-AGILE-24-10-01-C.

**Example output**

```json
{
  "count": 1,
  "current": {
    "payment_method": "DIRECT_DEBIT",
    "uk_time": "From 00:00 BST on Thu 1 Oct 2026",
    "valid_from": "2026-09-30T23:00:00Z",
    "valid_to": null,
    "value_exc_vat": 27.8484,
    "value_inc_vat": 29.24082
  },
  "has_more": false,
  "period_from": "2026-10-20T23:00:00Z",
  "period_to": null,
  "product_code": "VAR-22-11-01",
  "product_name": "Flexible Octopus",
  "rates": [
    {
      "payment_method": "DIRECT_DEBIT",
      "uk_time": "From 00:00 BST on Thu 1 Oct 2026",
      "valid_from": "2026-09-30T23:00:00Z",
      "valid_to": null,
      "value_exc_vat": 27.8484,
      "value_inc_vat": 29.24082
    }
  ],
  "region": "C",
  "region_name": "London",
  "tariff_code": "G-1R-VAR-22-11-01-C"
}
```

### Get gas unit rates

Get the price per kWh of gas on an Octopus tariff over a period, earliest first, with the current, lowest and highest.

**Inputs**

- Product (`product_code`, text, required): The Octopus product (tariff family). Pick one on sale now, or type any product code, such as VAR-22-11-01, from List products or a bill.
- Region (`region`, text, required): Your electricity region: prices differ between Great Britain's 14 regions. Find region for postcode looks yours up. One of: `A` (Eastern England (A)), `B` (East Midlands (B)), `C` (London (C)), `D` (Merseyside and North Wales (D)), `E` (West Midlands (E)), `F` (North East England (F)), `G` (North West England (G)), `H` (Southern England (H)), `J` (South East England (J)), `K` (South Wales (K)), and 4 more.
- From (`period_from`, date and time): The start of the period to list prices for. Leave empty for midnight today, UK time.
- Until (`period_to`, date and time): The end of the period. Leave empty for every price published from the start, which for Agile runs to 11pm tomorrow once tomorrow's prices are out.
- Paying by (`payment_method`, text): Variable tariffs cost more when not paid by Direct Debit. Prices that are the same either way are always listed. One of: `DIRECT_DEBIT` (Direct Debit), `NON_DIRECT_DEBIT` (Not by Direct Debit). Default: `DIRECT_DEBIT`.

**Outputs**

- `count` (number): How many unit rates are listed.
- `current` (object): The unit rate in force right now, or empty if the period is not now.
- `has_more` (true/false): True when the period holds more than one request returns (1,500 prices); only the latest are listed. Shorten the period to see the rest.
- `highest` (object): The dearest price listed (the first, on a tie).
- `lowest` (object): The cheapest price listed (the first, on a tie).
- `period_from` (text): The start of the period listed, ISO 8601 in UTC.
- `period_to` (text): The end of the period listed; empty for everything published since the start.
- `product_code` (text): The product the prices are for, such as AGILE-24-10-01.
- `product_name` (text): The product's name, such as Agile Octopus.
- `rates` (list): The unit rates, earliest first.
- `region` (text): The region's letter, A to P.
- `region_name` (text): The region's name, such as London.
- `tariff_code` (text): The tariff the prices are for, such as E-1R-AGILE-24-10-01-C.

**Example output**

```json
{
  "count": 1,
  "current": {
    "payment_method": "DIRECT_DEBIT",
    "uk_time": "From 00:00 BST on Thu 1 Oct 2026",
    "valid_from": "2026-09-30T23:00:00Z",
    "valid_to": null,
    "value_exc_vat": 7.7583,
    "value_inc_vat": 8.146215
  },
  "has_more": false,
  "highest": {
    "payment_method": "DIRECT_DEBIT",
    "uk_time": "From 00:00 BST on Thu 1 Oct 2026",
    "valid_from": "2026-09-30T23:00:00Z",
    "valid_to": null,
    "value_exc_vat": 7.7583,
    "value_inc_vat": 8.146215
  },
  "lowest": {
    "payment_method": "DIRECT_DEBIT",
    "uk_time": "From 00:00 BST on Thu 1 Oct 2026",
    "valid_from": "2026-09-30T23:00:00Z",
    "valid_to": null,
    "value_exc_vat": 7.7583,
    "value_inc_vat": 8.146215
  },
  "period_from": "2026-10-20T23:00:00Z",
  "period_to": null,
  "product_code": "VAR-22-11-01",
  "product_name": "Flexible Octopus",
  "rates": [
    {
      "payment_method": "DIRECT_DEBIT",
      "uk_time": "From 00:00 BST on Thu 1 Oct 2026",
      "valid_from": "2026-09-30T23:00:00Z",
      "valid_to": null,
      "value_exc_vat": 7.7583,
      "value_inc_vat": 8.146215
    }
  ],
  "region": "C",
  "region_name": "London",
  "tariff_code": "G-1R-VAR-22-11-01-C"
}
```

### Get product

Get one Octopus Energy product with its tariffs in each region: the tariff code, today's standing charge and unit rates (single, day and night, or EV charging, for electricity and gas) and any exit fee. Optionally for one region only.

**Inputs**

- Product (`product_code`, text, required): The Octopus product (tariff family). Pick one on sale now, or type any product code, such as VAR-22-11-01, from List products or a bill.
- Region (`region`, text): Only list the tariffs in this region. Leave empty for every region. One of: `A` (Eastern England (A)), `B` (East Midlands (B)), `C` (London (C)), `D` (Merseyside and North Wales (D)), `E` (West Midlands (E)), `F` (North East England (F)), `G` (North West England (G)), `H` (Southern England (H)), `J` (South East England (J)), `K` (South Wales (K)), and 4 more.

**Outputs**

- `available_from` (text): When new customers could first join it, ISO 8601.
- `available_to` (text): When it closes to new customers, ISO 8601; empty while open.
- `brand` (text): Who sells it: OCTOPUS_ENERGY, COOP_ENERGY, LONDON_POWER or BULB.
- `code` (text): The product code, such as AGILE-24-10-01: what the other actions take.
- `description` (text): Octopus's own summary of the product.
- `display_name` (text): The product's name, such as Agile Octopus.
- `full_name` (text): Its full name with the version, such as Agile Octopus October 2024 v1.
- `is_business` (true/false): True for a business product.
- `is_green` (true/false): True for a renewable electricity product.
- `is_prepay` (true/false): True for a prepayment (pay as you go) product.
- `is_restricted` (true/false): True when only some customers can join it, such as existing members.
- `is_tracker` (true/false): True for a tracker, whose price follows the wholesale market daily.
- `is_variable` (true/false): True when prices can change during the contract; false for a fixed deal.
- `tariff_count` (number): How many tariffs are listed.
- `tariffs` (list): The product's tariffs: one per region, kind of meter and way of paying, with today's prices.
- `term_months` (number): The contract length in months; empty when it has none.

**Example output**

```json
{
  "available_from": "2024-10-01T00:00:00+01:00",
  "available_to": null,
  "brand": "OCTOPUS_ENERGY",
  "code": "AGILE-24-10-01",
  "description": "With Agile Octopus, you get access to half-hourly energy prices, tied to wholesale prices and updated daily.  The unit rate is capped at 100p/kWh (including VAT).",
  "display_name": "Agile Octopus",
  "full_name": "Agile Octopus October 2024 v1",
  "is_business": false,
  "is_green": true,
  "is_prepay": false,
  "is_restricted": false,
  "is_tracker": false,
  "is_variable": true,
  "tariff_count": 1,
  "tariffs": [
    {
      "day_unit_rate_exc_vat": null,
      "day_unit_rate_inc_vat": null,
      "ev_off_peak_unit_rate_inc_vat": null,
      "ev_peak_unit_rate_inc_vat": null,
      "exit_fee_gbp": 0.0,
      "exit_fee_type": "NONE",
      "fuel": "Electricity",
      "meter": "Single rate",
      "night_unit_rate_exc_vat": null,
      "night_unit_rate_inc_vat": null,
      "payment": "Monthly Direct Debit",
      "region": "C",
      "region_name": "London",
      "standing_charge_exc_vat": 37.6525,
      "standing_charge_inc_vat": 37.6525,
      "tariff_code": "E-1R-AGILE-24-10-01-C",
      "unit_rate_exc_vat": 50.06,
      "unit_rate_inc_vat": 50.06
    }
  ],
  "term_months": 12
}
```

### List products

List the energy products (tariff families) Octopus Energy sells, such as Agile Octopus, Octopus Go and its fixed deals: whether each is variable, green, a tracker or prepayment, its term and when it went on sale. Filter by type, import or export, brand, or what was on sale at a past date.

**Inputs**

- Tariff type (`tariff_type`, text): Only variable or only fixed products. Leave empty for both. One of: `variable` (Variable: prices can change (Agile, Go, Flexible)), `fixed` (Fixed: prices locked for a term).
- Import or export (`direction`, text): Only products for buying energy, or only those paying for energy sent back to the grid. Leave empty for both. One of: `IMPORT` (Import: buying electricity or gas), `EXPORT` (Export: selling electricity back, e.g. from solar panels).
- Brand (`brand`, text): Only products sold under this brand. Octopus also supplies Co-op Energy and London Power customers. Leave empty for all. One of: `OCTOPUS_ENERGY` (Octopus Energy), `COOP_ENERGY` (Co-op Energy), `LONDON_POWER` (London Power), `BULB`.
- Green only (`green_only`, true/false): Only renewable electricity products. Default: `false`.
- Trackers only (`tracker_only`, true/false): Only tracker products, whose prices follow the wholesale market daily. Default: `false`.
- Prepayment only (`prepay_only`, true/false): Only prepayment (pay as you go) products. Default: `false`.
- Business products (`business`, true/false): List business products instead of products for homes. Default: `false`.
- Available at (`available_at`, date and time): List what was on sale to new customers at this date and time. Leave empty for what is on sale now.

**Outputs**

- `count` (number): How many products came back.
- `products` (list): The products, ordered by code.

**Example output**

```json
{
  "count": 2,
  "products": [
    {
      "available_from": "2024-10-01T00:00:00+01:00",
      "available_to": null,
      "brand": "OCTOPUS_ENERGY",
      "code": "AGILE-24-10-01",
      "description": "With Agile Octopus, you get access to half-hourly energy prices, tied to wholesale prices and updated daily.  The unit rate is capped at 100p/kWh (including VAT).",
      "direction": "Import",
      "display_name": "Agile Octopus",
      "full_name": "Agile Octopus October 2024 v1",
      "is_business": false,
      "is_green": true,
      "is_prepay": false,
      "is_restricted": false,
      "is_tracker": false,
      "is_variable": true,
      "term_months": 12
    },
    {
      "available_from": "2023-03-28T10:35:00+01:00",
      "available_to": null,
      "brand": "OCTOPUS_ENERGY",
      "code": "VAR-22-11-01",
      "description": "Flexible Octopus prices fluctuate with the cost of supply and usually update every 3 months.",
      "direction": "Import",
      "display_name": "Flexible Octopus",
      "full_name": "Flexible Octopus",
      "is_business": false,
      "is_green": false,
      "is_prepay": false,
      "is_restricted": false,
      "is_tracker": false,
      "is_variable": true,
      "term_months": null
    }
  ]
}
```
