# Centrica

> Centrica plc is the FTSE-listed British energy and services group behind British Gas, the United Kingdom's largest household energy supplier, along with Bord Gais Energy in Ireland, Centrica Business Solutions, Centrica Energy (wholesale power, gas and LNG trading) and the Hive connected-home brand. Its API posture is honestly closed: Britain mandated the smart-metering INFRASTRUCTURE — the licensed Smart DCC monopoly and the SMETS2 rollout — rather than a consumer data right, so Centrica publishes no consumer energy data API, no Green Button and no standards-conformant usage endpoint. The single publicly reachable developer surface is the Centrica FieldOps Azure API Management developer portal, a partner field-operations platform running in its development environment.

Generated by the API Evangelist enrichment pipeline on 2026-07-27 from apis.yml and the artifacts in this repository. Centrica publishes no llms.txt of its own — /llms.txt returns 404 on www.centrica.com, www.britishgas.co.uk, centricaenergy.com, api-developer.dev.fieldops.centrica.com and api.dev.fieldops.centrica.com.

## What you can and cannot get

- There is NO Centrica API for consumer or business energy usage, billing or account data. Household customers see consumption only inside the British Gas app and web account; business customers use the login-gated Energy360 DataView portal.
- The DESNZ non-domestic smart meter data access requirement (part one in force 1 December 2022, part two 1 October 2024) entitles a business customer or their nominated third party to up to twelve months of historic smart meter data free of charge. British Gas discharges it by written request answered within ten working days. It is a mandate, not an API.
- Centrica publishes no open grid or market data. The genuinely open UK energy data is published by NESO (Carbon Intensity), Elexon (BMRS/Insights) and the DNO open-data portals. Centrica consumes that data; it does not publish it.
- There is no Australian Consumer Data Right entry (no Australian operations) and no Green Button surface (Direct Energy was sold to NRG Energy on 5 January 2021, exiting North America).
- Hive, the connected-home brand, has never published an official public API. Community Home Assistant integrations reverse-engineer undocumented backends; beekeeper.hivehome.com answers 403.

## APIs

- [Centrica FieldOps Identity API](https://api-developer.dev.fieldops.centrica.com/api-details#api=identity-api): Token-issuing API on the Centrica FieldOps Azure API Management platform. A single POST /oauth2/token exchanges an OAuth 2.0 client_credentials grant for a bearer token used against the FieldOps WorkOrder, Opportunity and Appointment Slots APIs. Base URL https://api.dev.fieldops.centrica.com/api/v1/identity.

## Specs

- [OpenAPI 3.0.1 — FieldOps Identity API](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/openapi/centrica-fieldops-identity-api-openapi.yml): Exported verbatim from Centrica's own Azure APIM instance. One operation, operationId `oauth-access-token`.
- [OpenAPI Overlay](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/overlays/centrica-fieldops-identity-api-overlay.yaml): API Evangelist enhancements; the harvested spec itself is never mutated.

## Authentication and conventions

- [Authentication profile](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/authentication/centrica-authentication.yml): Azure APIM subscription key in the `Ocp-Apim-Subscription-Key` header or the `subscription-key` query parameter, plus an OAuth 2.0 client_credentials bearer token from the Identity API.
- [API conventions](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/conventions/centrica-conventions.yml): No idempotency contract, no pagination, no request-id header, no documented error envelope. Recorded as absent rather than assumed.
- [Rate limits](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/rate-limits/centrica-rate-limits.yml): Starter product 5 calls/minute up to 100 calls/week; Unlimited product unlimited with administrator approval.
- [Plans](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/plans/centrica-plans.yml): The two stock Azure APIM products. No prices are published.
- [Lifecycle](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/lifecycle/centrica-lifecycle.yml): URI-path versioning at v1. No deprecation policy, no changelog, no status page. The portal advertises 99.95% availability with no supporting SLA document.

## Discovery and security

- [Well-known index](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/well-known/centrica-well-known.yml): Five hosts probed, three documents found.
- [security.txt](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/well-known/centrica-security.txt): RFC 9116-shaped file on www.britishgas.co.uk pointing at the responsible-disclosure policy. Omits the required Contact and Expires fields.
- [OpenID Connect discovery](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/well-known/centrica-openid-configuration.json): A complete OIDC discovery document at https://www.centrica.com/.well-known/openid-configuration — but this is the Umbraco CMS member-authentication surface of the corporate website, not a developer API. The Umbraco Delivery API endpoints themselves are WAF-blocked (403).
- [Vulnerability disclosure](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/security/centrica-vulnerability-disclosure.yml): British Gas responsible-disclosure policy. No bug bounty programme.
- [Domain security](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/security/centrica-domain-security.yml): TLS 1.3 and one-year HSTS on the reachable web hosts; DMARC p=reject across centrica.com, britishgas.co.uk, bordgaisenergy.ie and hivehome.com; no CAA and no DNSSEC anywhere.
- [Conformance](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/conformance/centrica-conformance.yml): OpenAPI 3.0, OAuth 2.0, OIDC discovery, JWKS and PKCE yes; CDR energy, Green Button/ESPI, IEEE 2030.5, OpenADR, OCPP, OCPI and IEC CIM all no.

## Agent surface

- [Agent skills](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/skills/_index.yml): One skill, grounded in the single real operationId.
- [MCP](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/mcp/centrica-mcp.yml): Centrica publishes no MCP server. Its own APIM record reports `mcpProperties: null`, `a2aProperties: null`, `isAgent: false`. The tool list in that file is a derived candidate, not a published server.
- [Packages](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/packages/centrica-packages.yml): No first-party SDK exists in any registry.

## Sources

- [Centrica plc](https://www.centrica.com/)
- [British Gas](https://www.britishgas.co.uk/)
- [Centrica FieldOps API Management developer portal](https://api-developer.dev.fieldops.centrica.com/)
- [British Gas Business: the way businesses can request smart meter data is changing](https://www.britishgas.co.uk/business/blog/the-way-businesses-can-request-smart-meter-data-is-changing)
- [Energy360 DataView](https://www.britishgas.co.uk/business/gas-and-electricity/energy360)
- [Centrica Energy](https://centricaenergy.com/)
- [API Evangelist review](https://raw.githubusercontent.com/api-evangelist/centrica/refs/heads/main/review.yml)