SOAP to REST API Transition: Frequently Asked Questions

When will the SOAP API be decommissioned?
The SOAP API will be decommissioned on the 11th May 2026. From this date, the SOAP APIs will be permanently deleted.
Where can I access REST API documentation?
The REST API Transition Guide can be found on: REST API. Detailed REST API information can also be found on the API Developer portal: https://apideveloper.nationalgas.com/s/
Do I need authentication or an API Token to access this data?
As we have an open data policy, all REST APIs are accessible to public users without the need for an API Token or Authentication.
I am unable to access the REST API Developer Portal
If you have any issues accessing the API Developer Portal, please get in touch with our operational liaison team to help resolve the issue: [email protected]
Do you have any python scripts for REST API?
The API Developer Portal (https://apideveloper.nationalgas.com/s/) contains code examples for the following languages: cURL, HTTP, JavaScript – Fetch, JavaScript - Fetch/Async, JavaScript – Node, JavaScript – XHR, Python – Requests, Python - 2.7, Python - 3.1, C, Java – Platform, Java – Spring. To access these examples, select the desired endpoint and then choose a language from the dropdown menu under the code example header.
I retrieve data directly from the Gas Data Portal, will I be impacted by this Transition Initiative
There will be no impact on the Gas Data Portal due to this Transition Initiative. If you are retrieving data from the Gas Data Portal, then you won't need to make any changes to your existing processes.
I use Power Query to access my data, will I be impacted by this Transition Initiative
There will be no impact on Power Query users due to this Transition Initiative. If you are retrieving data via Power Queries, then you won't need to make any changes to your existing processes.
What impacts will I see on the SOAP API Service?
During the transition period there will be impacts to the performance and availability of the SOAP API Service. We will be reducing the API rate limits and be conducting regular outages to enable us to complete our decommission activities.
Where can I see the API Data Catalogue for Publications IDs?
You can access the API Data Catalogue by clicking here.
Will the data frequency and timings change?
No, the frequency and timings of when we publish data will remain the same as what was available for the SOAP API
Are these the Gemini APIs?
No, our APIs are not the Gemini APIs. The Gemini APIs are provided by xoserve. We provide both Data Item and Instantaneous Flow APIs which use National Gas endpoints/urls.
In Postman, do I need to keep the host header enabled?
Yes, if you are using Postman you will need to ensure your headers are enabled. As headers can be modified, disabling the Host header can cause the API server to reject the request.

We are here to help

If you need any support with your transition, please reach out to us at [email protected]

When will the SOAP API be decommissioned?
The SOAP API will be decommissioned on the 11th May 2026. From this date, the SOAP APIs will be permanently deleted.
Where can I access REST API documentation?
The REST API Transition Guide can be found on: REST API. Detailed REST API information can also be found on the API Developer portal: https://apideveloper.nationalgas.com/s/
Do I need authentication or an API Token to access this data?
As we have an open data policy, all REST APIs are accessible to public users without the need for an API Token or Authentication.
I am unable to access the REST API Developer Portal
If you have any issues accessing the API Developer Portal, please get in touch with our operational liaison team to help resolve the issue: [email protected]
Do you have any python scripts for REST API?
The API Developer Portal (https://apideveloper.nationalgas.com/s/) contains code examples for the following languages: cURL, HTTP, JavaScript – Fetch, JavaScript - Fetch/Async, JavaScript – Node, JavaScript – XHR, Python – Requests, Python - 2.7, Python - 3.1, C, Java – Platform, Java – Spring. To access these examples, select the desired endpoint and then choose a language from the dropdown menu under the code example header.
I retrieve data directly from the Gas Data Portal, will I be impacted by this Transition Initiative
There will be no impact on the Gas Data Portal due to this Transition Initiative. If you are retrieving data from the Gas Data Portal, then you won't need to make any changes to your existing processes.
I use Power Query to access my data, will I be impacted by this Transition Initiative
There will be no impact on Power Query users due to this Transition Initiative. If you are retrieving data via Power Queries, then you won't need to make any changes to your existing processes.
What impacts will I see on the SOAP API Service?
During the transition period there will be impacts to the performance and availability of the SOAP API Service. We will be reducing the API rate limits and be conducting regular outages to enable us to complete our decommission activities.
Where can I see the API Data Catalogue for Publications IDs?
You can access the API Data Catalogue by clicking here.
Will the data frequency and timings change?
No, the frequency and timings of when we publish data will remain the same as what was available for the SOAP API
Are these the Gemini APIs?
No, our APIs are not the Gemini APIs. The Gemini APIs are provided by xoserve. We provide both Data Item and Instantaneous Flow APIs which use National Gas endpoints/urls.
In Postman, do I need to keep the host header enabled?
Yes, if you are using Postman you will need to ensure your headers are enabled. As headers can be modified, disabling the Host header can cause the API server to reject the request.