Gas APIs

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. 

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. 

Email us

You can find a full list of the data items available in our Supply Point Quantities API Technical Specification.

View 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.

Email us

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.

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.