Gas APIs
Find out about our gas application programming interface (API) services, who can use them, and how to apply.
What are gas APIs?
Our gas application programming interfaces (gas APIs) are tools designed to improve the Supplier switching process.
APIs enable companies to open up their applications’ data and functionality to other businesses. Our APIs are tailored for the gas market, so customers such as gas Suppliers can gain access to consumer use data.
This helps them provide a better experience for people who are looking to switch their gas supply.
Find out more about APIs
What are APIs, how do they work and what do they do? Our short video includes some common business scenarios where APIs are useful.
Music featured in this video: "Jellyfish in Space" Kevin MacLeod (incompetech.com) Licensed under Creative Commons: By Attribution 4.0 License
Who can use gas API services?
Gas API Services are available to gas industry businesses only. These include:
- price comparison websites (PCWs)
- third-party intermediaries (TPIs)
- gas Shippers and Suppliers
- Meter Asset Providers (MAPs)
What gas API services are available?
We offer the Supply Point Quantities API direct to our customers.
The Supply Point Switching, Supply Point Enquiry and Meter Asset Enquiry APIs are all available through the Retail Energy Code Company (RECCo).
Supply Point Quantities API
This service is for industry customers who need quantifiable information from meter points. It provides access to domestic and non-domestic data, including:
- meter point information
- network information
- proposed formula year quantity values
Read the 'How to apply for the Supply Point Quantities API' section further down this page for instructions on how to apply.
For more information on this API, please email us at xoserve.customer.lifecycle.team@xoserve.co.uk.
You can find a full list of the data items available in our Supply Point Quantities API Technical Specification.
Who is eligible to use the service?
Only gas Shippers are eligible to use this service.
Supply Point Switching API
The Supply Point Switching API is part of the Gas Enquiry Service (GES). It’s provided in accordance with the Retail Energy Code (REC) and governed by the Retail Energy Code Company (RECCo).
Customers wanting to use this API need to contact the Retail Energy Code Company (RECCo) to confirm their eligibility and initiate the access process. You can do this by emailing enquiries@recmanager.co.uk.
Subject to the REC Data Access Matrix, this service is available to authorised GB gas industry customers who are working to improve the supplier switching process. It provides access to domestic and non-domestic data, including:
- meter point data
- supplier and network ID data
- Annual Quantity (AQ) data
The Supply Point Switching API technical specification is now hosted on the RECCo website. The related API password reset process can be accessed via the link below:
GES annual password reset process
Supply Point Enquiry API
The Supply Point Enquiry API is part of the Gas Enquiry Service (GES). It’s provided in accordance with the Retail Energy Code (REC) and governed by the Retail Energy Code Company (RECCo).
Customers wanting to use this API need to contact the Retail Energy Code Company (RECCo) to confirm their eligibility and initiate the access process. You can do this by emailing enquiries@recmanager.co.uk.
Subject to the REC Data Access Matrix, this service is available to customers working to improve change of supply and data assurance processes. It provides access to domestic and non-domestic data, including:
- meter point information
- supply information
- technical data for the supply point
The Supply Point Enquiry API technical specification is now hosted on the RECCo website.
Meter Asset Enquiry API
The Meter Asset Enquiry API is part of the Gas Enquiry Service (GES). It’s provided in accordance with the Retail Energy Code (REC) and governed by the Retail Energy Code Company (RECCo).
Customers wanting to use this API need to contact the Retail Energy Code Company (RECCo) to confirm their eligibility and initiate the access process. You can do this by emailing enquiries@recmanager.co.uk.
Subject to the REC Data Access Matrix, this service is available to customers who require meter asset data to help improve their data assurance processes. It provides access to domestic and non-domestic data.
The Meter Asset Enquiry API technical specification is now hosted on the RECCo website.
How to apply for the Supply Point Quantities API
You’ll need an active gas API service account with us to use the service. Contact our Customer Life Cycle team to get started.
How much does the Supply Point Quantities API cost?
Pricing is determined by an annual allowance of API calls (hits), which is categorised by "bands". The pricing of these bands will be detailed in your contract.
The table below shows the maximum allowance of API calls allowed each year for each band.
| Band | Allowance |
| A | 60,000 |
| B | 600,000 |
| C | 3,600,000 |
| D | 7,200,000 |
| E | 12,000,000 |
| F | 18,000,000 |
The Supply Point Switching, Supply Point Enquiry and Meter Point Enquiry APIs are part of the Gas Enquiry Service (GES). They are provided in accordance with the Retail Energy Code (REC) and governed by the Retail Energy Code Company (RECCo).
You can find charges for these services in the latest version of the REC Charging Statement. If you’re a consumer of these services, you can access the statement through the link below:
Category Products – REC Portal
Accessing and using the Supply Point Quantities API
Once we’ve checked your API application, we’ll send you a contract and all the information you’ll need to use our services.
After the contract has been countersigned, we’ll provide you with access details.
Data services
Contact us
Any questions about the Supply Point Quantities API? Please email our Customer Life Cycle team.
Try before you buy
You can try out our Supply Point Quantities API before making a purchase. Find out how in our guide.
Technical issues?
If you have any technical issues with your API subscription, please raise a support request.