Octopus Energy provide open access via API.
This API is used for the Octopus Energy Integration (BottlecapDave). Standard product information and tariffs are available without authorisation. Your account information is available, with authorisation.
You can do this, yourself, in about 5 minutes, just using the web browser you are using to read this post.
- log in to your Octopus Account online
- on the Home Page, click on the âpersonal detailsâ link under your name & account ref number
- under the block âDeveloper Settingsâ click on the âAPI Accessâ button
- on this page you will find:
- your API key. Take a copy of this and keep it safe somewhere. DO NOT DISCLOSE THIS KEY TO ANYONE
- your gas meter point MPRN
- your gas meter serial number
- create a URL using
https://{{apikey}}:@api.octopus.energy/v1/gas-meter-points/{{mprn}}/meters/{{meter}}/consumption
- in this string, replace {{apikey}} with your API key
- replace {{mprn}} with your MPRN
- replace {{meter}} with your meter number
- Paste this entire string directly into a browser search/URL bar [and hit the enter key]
You will see the results of the API call directly in the browser window. If you are using Chrome (I donât know about other browsers) the browser will recognise that the return is JSON and offer to âpretty printâ it for you . This helps.
You will get something like [I have *'d out my MPAN and meter number:
{
"count": 288,
"next": "https://api.octopus.energy/v1/gas-meter-points/**********/meters/**************/consumption/?page=2",
"previous": null,
"results": [
{
"consumption": 0,
"interval_start": "2026-01-20T23:30:00Z",
"interval_end": "2026-01-21T00:00:00Z"
},
{
"consumption": 0,
"interval_start": "2026-01-20T23:00:00Z",
"interval_end": "2026-01-20T23:30:00Z"
},
{
"consumption": 0,
"interval_start": "2026-01-20T22:30:00Z",
"interval_end": "2026-01-20T23:00:00Z"
},
Easy to do.
This returns the very latest Gas Consumption data that Octopus have for your account.
Note
At this point in time, 15:00 on Thursday 22nd January, Octopus have my gas consumption data up to the period 20th at 23:30 to midnight.
This is not yesterdayâs data, this is the day before yesterday. Octopus do not have yesterdayâs gas data, and therefore there is no way either I or the Octopus Energy integration can get this.
Gas readings are always late, often very late, and sometimes never there.