This is not our API. This repository is an independent, third-party profile of a company's publicly available API surface, maintained by API Evangelist. API Evangelist does not operate, host, resell, or support this company's APIs, and is not affiliated with or endorsed by the company unless stated on the profile.
Where the information came from. Everything here is assembled from material a member of the public can reach with a browser and no credentials — the company's own website, developer portal and documentation, the specifications it publishes for public use (OpenAPI, AsyncAPI, JSON Schema,
apis.json,llms.txtand similar), its public repositories, and its public status, pricing and changelog pages. Nothing here is obtained by breaching a system, defeating an access control, or using credentials of any kind.The rating is an independent assessment. The Kin Score and Agent Readiness rating are independently calculated scores of a company's public API artifacts, produced by API Evangelist against a published rubric. They are not certifications, endorsements, security assessments, or audits, and they score published artifacts — not the quality, safety, or security of the software.
Corrections, re-scores, and removal are free. No partnership, contract, or purchase is required, and you do not need to justify the request.
- Something wrong? Open an issue on this repository, or email info@apievangelist.com.
- Published something new? Ask for a re-score and we will re-run the rating.
- Want the listing taken down? Say so and we will honor it. The profile is reduced to your company name, a factual description, and a link to your own site, and the company is recorded as unrated — never scored zero for having asked.
Response times. Acknowledgement within one business day; removal or restriction within two business days; corrections and re-scores within five business days.
On a security or compliance team? Email info@apievangelist.com with security in the subject line and you will get a person, not a form. We will tell you exactly which public URLs this profile was built from so your team can see the same surface we did, and we will take the listing down on request while you work through it.
Full detail: Where this data comes from
Xoserve Limited is the Central Data Services Provider (CDSP) for Great Britain's gas market — funded, governed and owned by the gas industry itself. It operates the central register of every gas supply point in Britain and runs the systems the market clears through: UK Link, the Gemini transmission system, the Gas Enquiry Service, the Contact Management Service, SwitchStream and the Data Discovery Platform. It sits between the gas transporters, the independent gas transporters, the shippers and the retail suppliers under the Uniform Network Code (UNC) and the Data Services Contract (DSC), with further obligations under the Retail Energy Code. Britain mandated this data infrastructure, not a consumer data right: there is no CDR-style, consent-driven data portability obligation on Xoserve, and no Green Button or Consumer Data Standards implementation. Xoserve does publish a real developer portal — the Discovery API Platform, delivered by its service provider Correla — where four documented REST APIs expose meter-point-level information, browsable anonymously but callable only by eligible, contracted GB gas industry parties.
APIs.json: https://raw.githubusercontent.com/api-evangelist/xoserve/refs/heads/main/apis.yml
- Energy
- United Kingdom
- Gas
- Utilities
- Energy Markets
- Meter Data
- Gas Networks
- Central Data Service Provider
- Data Services
- Created: 2026-07-27
- Modified: 2026-07-27
Bundled by Xoserve as the Supply Point Quantities service. Lets gas Shippers view the proposed Formula Year (Billing) Annual Quantity value for a meter point ahead of the late-March notification to the current Shipper, together with meter point and network information. A single GET operation filtered by MPRN, or by postcode combined with optional address detail. Returns JSON or XML. Available to Gas Shippers only, after contract countersigning.
- Human URL: https://discoveryapiportal.correla.com/api-details#api=shipper&operation=getShipper_1
- Base URL:
https://discoveryapi.correla.com/shipper/v1
- Gas
- Supply Point
- Annual Quantity
- Energy Markets
Bundled by Xoserve as the Supply Point Enquiry service, part of the Gas Enquiry Service (GES). Exposes detailed supply meter point information, filtered by MPRN, address_id or postcode combined with optional address detail. Aimed at organisations working to improve change-of-supply and data assurance processes. Access is arranged through the Retail Energy Code Company (RECCo), not directly with Xoserve.
- Human URL: https://discoveryapiportal.correla.com/api-details#api=supplier&operation=getSupplier_1
- Base URL:
https://discoveryapi.correla.com/supplier/v1
- Gas
- Supply Point
- Switching
- Retail Energy Code
Bundled by Xoserve as the Meter Asset Enquiry service. Exposes detailed meter asset information for GB gas meter points, filtered by MPRN and/or MSN (meter serial number). Intended for organisations improving data assurance processes. Access is arranged through the Retail Energy Code Company (RECCo).
- Human URL: https://discoveryapiportal.correla.com/api-details#api=meter-asset&operation=getMeterAsset_1
- Base URL:
https://discoveryapi.correla.com/meter-asset/v1
- Gas
- Meter Asset
- Data Assurance
Version 2 of the Meter Asset Enquiry API, described by Xoserve as containing additional output fields compared with v1. Same MPRN and MSN filters, same segment-versioned gateway path. This is the version bundled into the current Meter Asset Enquiry product.
- Human URL: https://discoveryapiportal.correla.com/api-details#api=meter-asset-v2&operation=getMeterAsset_1
- Base URL:
https://discoveryapi.correla.com/meter-asset/v2
- Gas
- Meter Asset
- Data Assurance
- Website
- Portal
- Documentation
- Sign Up
- Pricing
- Blog
- Support
- Terms of Service
- Privacy Policy
- Getting Started — Try Before You Buy subscription guide (PDF)
- Status — Planned outages and Live updates
- Change Log — UK Link releases
- Compliance — accreditations (ISO/IEC 27001:2022, ISO 9001:2015)
Harvested or derived on 2026-07-27. The headline find of this round: Azure API Management strips
paths and components from the anonymous OpenAPI export, but the operation detail and component
schemas are separately retrievable from the same portal at /developer/apis/{api}/operations/{op}
and /developer/apis/{api}/schemas/{schemaId}. Those provider-published documents are saved verbatim
to json-schema/ and examples/, and reconstituted into complete operations via overlays/ — the
harvested openapi/ exports are left untouched.
- json-schema/ — provider-published component schemas (ShipperResponse 24 fields, SupplierFull 89, MeterAsset 16 in v1 / 42 in v2)
- examples/ — provider-published response examples, one per API
- overlays/ — OpenAPI Overlay 1.0.0 per spec: real operation, parameters, responses, schemas, and the corrected version-segmented
serversURL - authentication/ — Azure APIM subscription key model, access routes, live
WWW-Authenticatechallenge - conventions/ — read-only estate, mandatory query filters, JSON/XML, no pagination, no idempotency key needed (all GETs)
- errors/ — Azure APIM
{statusCode, message}envelope (not RFC 9457), 401/404 captured live - lifecycle/ — segment versioning, concurrent Meter Asset v1/v2, release programme, status surfaces, maintenance windows
- changelog/ — the UK Link major release schedule (there is no API-level changelog)
- plans/ and rate-limits/ — the published annual call-allowance bands A–F (60,000 to 18,000,000 calls/year)
- sandbox/ — the "Try Before You Buy" trial on a separate SAP BTP launchpad, against a privately issued dummy dataset
- conformance/ — standards conformance plus the published ISO 27001:2022 / ISO 9001:2015 certifications
- data-model/ — the MPRN-centred entity graph reconstructed from the component schemas
- security/ — TLS/HSTS/DNSSEC/CAA/SPF/DMARC probe results
- skills/ — three packaged Agent Skills grounded in the real operationIds
- agentic-access/ —
x-agentic-accesscontracts (all read/connected, but subject + purpose + audit required) - mcp/ — a derived candidate tool set and REST crosswalk; Xoserve operates no MCP server
- llms/ — generated
llms.txt(Xoserve publishes none) - well-known/ and packages/ — recorded negative results: no
/.well-known/surface on any host, no first-party SDKs, no GitHub organization
- Mandate regime: Other — Uniform Network Code (UNC) and Data Services Contract (DSC), plus Retail Energy Code (REC) obligations for the Gas Enquiry Service APIs. This is a market-infrastructure mandate on a monopoly central data provider, not a consumer data right. Not the Australian CDR, not Green Button.
- Mandate status: Live and implemented — verified by an anonymously readable API catalogue, four provider-generated OpenAPI exports, and a live gateway returning HTTP 401 (not 404) on every documented route.
- Data standard: No standard reference found. Proprietary GB gas market schema (MPRN, MSN, AQ, SOQ, exit zone, LDZ). ENTSO-E Energy Identification Codes and Market Domain Data are published as documents, not APIs.
- Consumer data API: Yes, but by industry accreditation rather than consumer consent — a licensed Shipper or REC party can retrieve an individual meter point's quantities and supplier detail; a consumer or their agent cannot.
- Open market data: No. Xoserve publishes no keyless machine-readable market or system data API. Its public outputs are the Market Domain Data spreadsheet and the free findmysupplier consumer lookup it operates.
- Access gate: Accredited only. Browsing the portal is open; keys require eligible licensed GB gas industry status plus a countersigned contract, arranged by email with Xoserve's Customer Life Cycle team or with RECCo for the GES APIs.
- Auth model: API key —
APIKeyheader orsubscription-keyquery parameter (Azure API Management). No OAuth 2.0, no OpenID Connect, no mTLS. - Home market: United Kingdom (Great Britain gas market).
See review.yml for the full probe log, evidence, and provenance of every harvested artifact.