Octopus Energy

App · 8 actions

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.

Actions

ActionWhat it does
Find cheapest electricity timesFind 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.
Find region for postcodeFind which of Great Britain's 14 electricity regions a postcode is in.
Get electricity standing chargesGet 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.
Get electricity unit ratesGet 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.
Get gas standing chargesGet the daily gas standing charge of an Octopus tariff over a period, earliest first, with the one in force now.
Get gas unit ratesGet the price per kWh of gas on an Octopus tariff over a period, earliest first, with the current, lowest and highest.
Get productGet 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.
List productsList 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.

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

RegionregiontextRequired
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.
Productproduct_codetext
The Octopus product. Leave empty for Agile Octopus, whose prices change every half hour; or pick or type another, such as Octopus Go.
Hours neededhoursnumber
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 rowconsecutivetrue/false
Find one unbroken block of time. Turn off to take the cheapest half hours wherever they fall.Default: true.
Search fromperiod_fromdate and time
The earliest time to start. Leave empty for now.
Finish byperiod_todate 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_vatnumber
The same average excluding VAT.
average_inc_vatnumber
The average unit rate of the chosen half hours, pence per kWh including VAT.
consecutivetrue/false
True when the half hours had to be in a row.
endtext
When the last chosen half hour ends, ISO 8601 in UTC.
hoursnumber
The hours asked for.
prices_known_untiltext
The end of the last half hour with a published price in the window: later times could not be considered yet.
product_codetext
The product searched, such as AGILE-24-10-01.
product_nametext
Its name, such as Agile Octopus.
regiontext
The region's letter, A to P.
region_nametext
The region's name, such as London.
searched_fromtext
The start of the window searched, ISO 8601 in UTC.
searched_totext
The end of the window searched, ISO 8601 in UTC.
slot_countnumber
How many half hours were chosen.
slotslist
The chosen half hours, earliest first.
starttext
When the first chosen half hour starts, ISO 8601 in UTC.
tariff_codetext
The tariff searched, such as E-1R-AGILE-24-10-01-C.
uk_timetext
From start to end on the UK clock, such as 01:00 to 03:00 BST on Thu 22 Oct 2026.
Example output
{
  "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

PostcodepostcodetextRequired
A full postcode in Great Britain.

Outputs

countnumber
How many regions the postcode is in.
postcodetext
The postcode looked up, tidied, such as SW1A 1AA.
regiontext
The region's letter, A to P, to use in the other actions. Empty when the postcode spans two regions: regions lists both.
region_nametext
The region's name, such as London.
regionslist
Every region the postcode is in (almost always one).
Example output
{
  "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

Productproduct_codetextRequired
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.
RegionregiontextRequired
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.
Metermetertext
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.
Fromperiod_fromdate and time
The start of the period to list prices for. Leave empty for midnight today, UK time.
Untilperiod_todate 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 bypayment_methodtext
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

countnumber
How many standing charges are listed.
currentobject
The standing charge in force right now, or empty if the period is not now.
has_moretrue/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.
metertext
The kind of meter: single or day_night.
period_fromtext
The start of the period listed, ISO 8601 in UTC.
period_totext
The end of the period listed; empty for everything published since the start.
product_codetext
The product the prices are for, such as AGILE-24-10-01.
product_nametext
The product's name, such as Agile Octopus.
rateslist
The standing charges, earliest first.
regiontext
The region's letter, A to P.
region_nametext
The region's name, such as London.
tariff_codetext
The tariff the prices are for, such as E-1R-AGILE-24-10-01-C.
Example output
{
  "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

RegionregiontextRequired
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.
Productproduct_codetext
The Octopus product. Leave empty for Agile Octopus, whose prices change every half hour; or pick or type another, such as Octopus Go.
Rateratetext
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.
Fromperiod_fromdate and time
The start of the period to list prices for. Leave empty for midnight today, UK time.
Untilperiod_todate 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 bypayment_methodtext
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

countnumber
How many unit rates are listed.
currentobject
The unit rate in force right now, or empty if the period is not now.
has_moretrue/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.
highestobject
The dearest price listed (the first, on a tie).
lowestobject
The cheapest price listed (the first, on a tie).
period_fromtext
The start of the period listed, ISO 8601 in UTC.
period_totext
The end of the period listed; empty for everything published since the start.
product_codetext
The product the prices are for, such as AGILE-24-10-01.
product_nametext
The product's name, such as Agile Octopus.
ratetext
Which rate: standard, day, night, ev_peak or ev_off_peak.
rateslist
The unit rates, earliest first.
regiontext
The region's letter, A to P.
region_nametext
The region's name, such as London.
tariff_codetext
The tariff the prices are for, such as E-1R-AGILE-24-10-01-C.
Example output
{
  "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

Productproduct_codetextRequired
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.
RegionregiontextRequired
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.
Fromperiod_fromdate and time
The start of the period to list prices for. Leave empty for midnight today, UK time.
Untilperiod_todate 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 bypayment_methodtext
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

countnumber
How many standing charges are listed.
currentobject
The standing charge in force right now, or empty if the period is not now.
has_moretrue/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_fromtext
The start of the period listed, ISO 8601 in UTC.
period_totext
The end of the period listed; empty for everything published since the start.
product_codetext
The product the prices are for, such as AGILE-24-10-01.
product_nametext
The product's name, such as Agile Octopus.
rateslist
The standing charges, earliest first.
regiontext
The region's letter, A to P.
region_nametext
The region's name, such as London.
tariff_codetext
The tariff the prices are for, such as E-1R-AGILE-24-10-01-C.
Example output
{
  "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

Productproduct_codetextRequired
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.
RegionregiontextRequired
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.
Fromperiod_fromdate and time
The start of the period to list prices for. Leave empty for midnight today, UK time.
Untilperiod_todate 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 bypayment_methodtext
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

countnumber
How many unit rates are listed.
currentobject
The unit rate in force right now, or empty if the period is not now.
has_moretrue/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.
highestobject
The dearest price listed (the first, on a tie).
lowestobject
The cheapest price listed (the first, on a tie).
period_fromtext
The start of the period listed, ISO 8601 in UTC.
period_totext
The end of the period listed; empty for everything published since the start.
product_codetext
The product the prices are for, such as AGILE-24-10-01.
product_nametext
The product's name, such as Agile Octopus.
rateslist
The unit rates, earliest first.
regiontext
The region's letter, A to P.
region_nametext
The region's name, such as London.
tariff_codetext
The tariff the prices are for, such as E-1R-AGILE-24-10-01-C.
Example output
{
  "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

Productproduct_codetextRequired
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.
Regionregiontext
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_fromtext
When new customers could first join it, ISO 8601.
available_totext
When it closes to new customers, ISO 8601; empty while open.
brandtext
Who sells it: OCTOPUS_ENERGY, COOP_ENERGY, LONDON_POWER or BULB.
codetext
The product code, such as AGILE-24-10-01: what the other actions take.
descriptiontext
Octopus's own summary of the product.
display_nametext
The product's name, such as Agile Octopus.
full_nametext
Its full name with the version, such as Agile Octopus October 2024 v1.
is_businesstrue/false
True for a business product.
is_greentrue/false
True for a renewable electricity product.
is_prepaytrue/false
True for a prepayment (pay as you go) product.
is_restrictedtrue/false
True when only some customers can join it, such as existing members.
is_trackertrue/false
True for a tracker, whose price follows the wholesale market daily.
is_variabletrue/false
True when prices can change during the contract; false for a fixed deal.
tariff_countnumber
How many tariffs are listed.
tariffslist
The product's tariffs: one per region, kind of meter and way of paying, with today's prices.
term_monthsnumber
The contract length in months; empty when it has none.
Example output
{
  "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 typetariff_typetext
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 exportdirectiontext
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).
Brandbrandtext
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 onlygreen_onlytrue/false
Only renewable electricity products.Default: false.
Trackers onlytracker_onlytrue/false
Only tracker products, whose prices follow the wholesale market daily.Default: false.
Prepayment onlyprepay_onlytrue/false
Only prepayment (pay as you go) products.Default: false.
Business productsbusinesstrue/false
List business products instead of products for homes.Default: false.
Available atavailable_atdate and time
List what was on sale to new customers at this date and time. Leave empty for what is on sale now.

Outputs

countnumber
How many products came back.
productslist
The products, ordered by code.
Example output
{
  "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
    }
  ]
}

On this page