Hi Ovo,
I wondered whether the API that powers your live and historical usage page in the account menu is something you could look into opening up a bit so we can freely access our raw data and also perhaps it may stimulate some interesting community projects?
Best answer by g-de
Updated on 14/08/25 by Abby_OVO
Tim_OVO: “We love seeing the innovative ways our customers are using tech to help monitor and manage their energy usage. It’s inspiring us to think about ways to do energy differently. We know some customers have been using some of the application programming interface (APIs) behind our public facing services. While we’re OK with that, we do need to make you aware of a couple of things.
These APIs are designed to be used by OVO teams only, and aren't public facing. There are some downsides to using APIs that aren't for the public, and we wanted to let you know what these are. Behind the scenes, OVO uses APIs to share and update information between systems that power your bills and your online account. This is done in partnership with Kaluza, the tech company that’s part of the OVO family. They’ve built the billing platform designed to put our customers in the driving seat of their energy usage.
These internal APIs are intended for use by Kaluza and its clients, who are energy retailers like OVO, rather than customers. Because of this, there’s no support for them being used anywhere else, which means they may be discontinued with no notice when we update our products and services.
OVO Energy and Kaluza need to be able to monitor these APIs, and may block access if there's any problems in the future.
We know some customers may have put time and effort into developing solutions that use these API. So, now that you know the risks, we want to hear from you on how you’re using the APIs and the problems you’re solving with your DIY approach.
Is there anything you’d like to see from OVO to help you monitor and manage your energy better? Leave a comment below to tell us.”
can you help me understand if the links above allow users to access raw data as if from an API?
I can certainly give it a go.
Firstly, big thanks to Timmo and other contributors for developing the library. All thanks go to them and links to buy them a coffee for their effort can be found on PyPi or GitHub:
https://pypi.org/project/ovoenergy/
https://github.com/timmo001/ovoenergy
I assume the way the library was developed this was to reverse engineer the My OVO website. That is, browse the website as normal and and monitor the traffic to see what OVO URLs and APIs it uses. Assuming this is the case, one of these URLs (get account IDs) already seems to be different but the library is still working for the moment. The APIs being used are not officially supported outside of the website, so first, a warning that any changes to the My OVO website may break the library.
For anyone using Python, you should be able to include the ovoenergy library and look at https://github.com/timmo001/ovoenergy/blob/master/ovoenergy/cli.py for how to use it.
For replicating this in other languages, the process seems to be as follows:
{
"username": "...",
"password": "...",
"rememberMe": true
}From the response, save the cookies to use in all future requests.
You can also get monthly or half-hourly usage using the following URLs similar to step 3:
As mentioned above, if this is wanted for Home Assistant, the integration was added in version 0.114 (https://www.home-assistant.io/integrations/ovo_energy/).
Unfortunately the data only goes up to the end of the previous day as OVO no longer provide real-time data:
Log file lines from last Uri are as follows:
2024-11-06 17:20:52 - Uri: https://smartpaymapi.ovoenergy.com/usage/api/monthly/nnnnnnn?date=2020
2024-11-06 17:20:52 - System.NullReferenceException: Object reference not set to an instance of an object.
at OvoData.Helpers.SqliteHelper.UpsertMonthly(String fuelType, List`1 items) in C:\Dev\Mike\GitHub\My-Ovo-Data\Helpers\SqliteHelper.cs:line 114
at OvoData.MainWindow.OnClick_Read(Object sender, RoutedEventArgs e) in C:\Dev\Mike\GitHub\My-Ovo-Data\MainWindow.xaml.cs:line 189
Let me know if you need more.
Posted the requested information but apparently it needs to be revewed by the moderators. In case that takes time, the exception line was:
2024-11-06 17:20:52 - System.NullReferenceException: Object reference not set to an instance of an object.
at OvoData.Helpers.SqliteHelper.UpsertMonthly(String fuelType, List`1 items) in C:\Dev\Mike\GitHub\My-Ovo-Data\Helpers\SqliteHelper.cs:line 114
at OvoData.MainWindow.OnClick_Read(Object sender, RoutedEventArgs e) in C:\Dev\Mike\GitHub\My-Ovo-Data\MainWindow.xaml.cs:line 189
That was preceded in the log by the Uri line which was https: slash slash smartpaymapi.ovoenergy.com slash usage slash api slash monthly slash accountNo?date=2020
No other lines in the log between those two entries. Let me know if you need more.
That is interesting in that the URL ends 2020.
Is that year significant?
Can you PM me the whole log file please?
The year isn’t significant to me, as far as I can see. The whole log file (4554 lines, 342k) is being sent to you in a PM, but it seems to be taking a while … having clicked “send” the button is just being highlighted continually with three white dots. This is the first time I’ve used PM so I may have done something wrong?
Edit: Just checked my online account. The last bill I can see online is for May-Jun 2020. I have been an OVO customer since 2013. Interestingly, I can see Usage data going back to 2013, but not the bills!
With the kind assistance of
My code could not cope with him having “free” 😁 electricity prior to May.
The data segments were missing, causing my code to error.
This is now fixed and I intend to release this later this week.
/Mike Williams
I have just released V1.0.3 of my app to GitHub, this fixes the issue found by
Just download the zip file from https://github.com/MikeWilliams-UK/My-Ovo-Data/releases and unzip it’s contents to any folder, then run OvoData.exe
If you like my work, please consider donating at https://www.buymeacoffee.com/mikewilliamsuk
/Mike Williams
Those who just want to dump half-hourly usage for archival purposes (JSON, CSV) might find this script helpful: https://github.com/nickcmaynard/ovo-energy-usage-scripts
Those who just want to dump half-hourly usage for archival purposes (JSON, CSV) might find this script helpful: https://github.com/nickcmaynard/ovo-energy-usage-scripts
Hi All,
I have been informed by
I have investigated this using postman and I can see that the API is working but retriving empty data sets for anything in 2025.
This tallys exactly with the OVO website, so I think we will just have to wait for them to fix the API.
Just tried to chat with someone at OVO, but the chat bot failed to connect me with a real person.
Maybe it will all stat to work again tomorrow when their system has at least two days daya from 2025 (fingers crossed)
+8Please see https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository for instructions on how to remove sensitive data from a GitHub repository. I would strongly recommend doing so in this case.
Ho hum, thanks folks - should be fixed now!
Hi All,
Just checked on the OVO web site and the page for viewing “Your enery use” is now working (for me).
My app is also working again (for me), please remember to chose “This month & Last month” to ensure that December’s data is retrieved.
/Mike
+4Great news
Has the API stopped working? Haven’t been able to get data for the last couple of days. I am Gas only.
+8If the API is completely dead, you wouldn’t be able to see anything in MyOVO either.
Worth remembering however that OVO doesn’t make any promises it’ll work for anything but MyOVO.
Hi
June is showing as having all Half Hour records.
I am Electric & Gas customer.
I can’t get the half-hourly usage for 1 July on the official page (doesn’t seem to be called MyOVO anymore). It gives a reasonable looking total, but not the details.
+8Usage data for the 2nd July probably isn’t ready yet - it generally starts to become available in the afternoon from around 1pm onwards.
+9The other thing to consider
+7Has the API stopped working? Haven’t been able to get data for the last couple of days. I am Gas only.
I wasn’t able to retrieve Hh data for 1 July, neither via the API nor the website, until a few moments ago (09:15 BST on 03 July). Meter index readings for 2 July turned up at about the same time. It looks like there has been a delay in collecting data from meters via DCC since the start of the new quarter, but the API can only return data that has already been retrieved.
I find it less stressful to collect my Hh data from n3rgy.com, but I still have to wait until 10:00 BST before n3rgy will get them for me.
Hi All,
Just a quick heads up OVO have changed their API.
My program will not work until I have had time to fix it.
Sorry about that folks, but when we use an undocumented API which is probably designed to be internal to OVO we are always at the mercy of when they decide to change their API.
Thanks
Regards
Mike Williams
+7
People may have noticed that utilities like the ones described in this thread aren’t working these days. It looks like there was a fundamental change in the way that authorization works for the API. This sort of stuff sadly goes right over my head, but apparently it’s no longer enough to have the browser cache an access token; it actually has to be sent with each request. Developers out there will hopefully know how to deal with this, so over to
I won’t be able to fix it either as I changed to Fuse on the 30th of September because they had me at 41p a day standing charge for electricity and every other thing cheaper than the fixed deals Ovo offered. £150 cheaper a year, no direct debit “estimates” and no power move nonsense.
If I find a way of fixing it I’d have a go but I don’t know if I’ll be able to test it.
No account yet? Create an account
Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.
OVO Energy Ltd, registered office 1 Rivergate Temple Quay Bristol, BS1 6ED, company no. 06890795 registered in England and Wales.
OVO (S) Gas Limited is registered in England and Wales (Company No. 02716495) at 1 Rivergate, Temple Quay, Bristol, BS1 6ED.
OVO (S) Gas Limited is part of OVO Group Ltd
