Gas APIs

Find out about our gas application programming interface (API) services, who can use them, and how to apply.

Page contents

    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

    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.

    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.

    Contact us

    Any questions about the Supply Point Quantities API? Please email our Customer Life Cycle team.

    Email us

    Try before you buy

    You can try out our Supply Point Quantities API before making a purchase. Find out how in our guide.

    View guide

    Technical issues?

    If you have any technical issues with your API subscription, please raise a support request.

    Raise a support request
    Making switching easy
    SwitchStream