aid: neso
url: https://raw.githubusercontent.com/api-evangelist/neso/refs/heads/main/apis.yml
name: National Energy System Operator (NESO)
kind: company
description: The National Energy System Operator (NESO) is Great Britain's publicly owned,
  operationally independent electricity system operator and whole-energy system planner, created
  on 1 October 2024 when the UK government purchased National Grid Electricity System Operator
  Limited and folded in gas system planning from National Gas Transmission. NESO balances
  the GB electricity system in real time, runs the connections queue, publishes Future Energy
  Scenarios, and sits at the centre of the value chain between generators, interconnectors,
  transmission and distribution networks, and suppliers. Its API posture is the sector's classic
  split, and NESO lands firmly on the open side of that split. Market and system data is genuinely
  open and anonymous - the NESO Data Portal exposes 128 datasets over a public CKAN API at
  api.neso.energy with no key, no account and no application, all under the permissive NESO
  Open Data Licence, and the Carbon Intensity API for Great Britain that NESO develops is
  one of the most openly consumed public energy APIs in the world. There is no consumer data
  surface at all, and none is expected, because NESO holds no retail customer relationships,
  Britain has no consumer energy data-portability mandate comparable to the Australian Consumer
  Data Right, and smart-meter consumption data travels through the licensed Smart DCC monopoly
  rather than through the system operator. NESO's open-data obligation comes from Ofgem's
  Data Best Practice Guidance embedded in its RIIO-2 licence, and unlike most of the sector
  that obligation is visibly implemented rather than merely claimed.
deliveryModel:
  model: saas
  license_evidence:
    not_product:
    - carbon-intensity/api-definitions
  open_source: unknown
  commercial: true
  callable_host: false
  label: Hosted service · you call their endpoint
  confidence: low
  source:
  - pricing
  - repository-not-product
  generated: '2026-09-25'
  method: derived
accessModel:
  pricing: free
  onboarding: open
  trial: false
  try_now: true
  public: true
  label: Free - Open, no registration
  confidence: high
  source:
  - probe
  generated: '2026-07-27'
  method: observed
image: https://www.neso.energy/themes/custom/neso_theme/logo.svg
tags:
- Energy
- United Kingdom
- Electricity
- Energy Markets
- Grid
- Open Data
- Carbon
- Renewables
- Gas
- Demand Response
- Carbon Intensity
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.23'
apis:
- aid: neso:neso-carbon-intensity-api
  name: Carbon Intensity API
  description: >-
    The official Carbon Intensity API for Great Britain, developed by NESO, giving national and regional
    carbon intensity of GB electricity - actual, forecast up to 96+ hours ahead, half-hourly generation
    mix, per-fuel emission factors, and regional breakdowns by DNO region, region id, or postcode. Fully
    anonymous REST/JSON over HTTPS with no API key and no registration; documented as a Slate reference
    site rather than as a downloadable OpenAPI contract.
  humanURL: https://carbon-intensity.github.io/api-definitions/
  baseURL: https://api.carbonintensity.org.uk
  tags:
  - Carbon
  - Electricity
  - Renewables
  - Grid
  - Open Data
  properties:
  - type: APIReference
    url: https://carbon-intensity.github.io/api-definitions/
  - type: Documentation
    url: https://carbonintensity.org.uk/
  - type: GitHubOrganization
    url: https://github.com/carbon-intensity
  - type: SourceCode
    url: https://github.com/carbon-intensity/api-definitions
  - type: TermsOfService
    url: https://github.com/carbon-intensity/terms
  - type: Authentication
    url: authentication/neso-authentication.yml
  - type: Conventions
    url: conventions/neso-conventions.yml
  - type: ErrorCatalog
    url: errors/neso-error-codes.yml
  - type: DataModel
    url: data-model/neso-data-model.yml
- aid: neso:neso-datastore-api
  name: National Energy System Operator (NESO) Datastore API
  description: Query tabular data with filters or PostgreSQL-style SQL.
  humanURL: https://www.neso.energy/data-portal/api-guidance
  baseURL: https://api.neso.energy/api/3/action
  tags:
  - Datastore
  properties:
  - type: OpenAPI
    url: openapi/neso-datastore-api-openapi.yml
  - type: Documentation
    url: https://www.neso.energy/data-portal
  - type: APIReference
    url: https://www.neso.energy/data-portal/api-guidance
  - type: Licensing
    url: https://www.neso.energy/data-portal/neso-open-licence
  - type: RateLimits
    url: rate-limits/neso-rate-limits.yml
  - type: Authentication
    url: authentication/neso-authentication.yml
  - type: Conventions
    url: conventions/neso-conventions.yml
  - type: ErrorCatalog
    url: errors/neso-error-codes.yml
  - type: DataModel
    url: data-model/neso-data-model.yml
- aid: neso:neso-discovery-api
  name: National Energy System Operator (NESO) Discovery API
  description: Discovery endpoints for organizations, datasets, and tags.
  humanURL: https://www.neso.energy/data-portal/api-guidance
  baseURL: https://api.neso.energy/api/3/action
  tags:
  - Discovery
  properties:
  - type: OpenAPI
    url: openapi/neso-discovery-api-openapi.yml
  - type: Documentation
    url: https://www.neso.energy/data-portal
  - type: APIReference
    url: https://www.neso.energy/data-portal/api-guidance
  - type: Licensing
    url: https://www.neso.energy/data-portal/neso-open-licence
  - type: RateLimits
    url: rate-limits/neso-rate-limits.yml
  - type: Authentication
    url: authentication/neso-authentication.yml
  - type: Conventions
    url: conventions/neso-conventions.yml
  - type: ErrorCatalog
    url: errors/neso-error-codes.yml
  - type: DataModel
    url: data-model/neso-data-model.yml
- aid: neso:neso-metadata-api
  name: National Energy System Operator (NESO) Metadata API
  description: Retrieve metadata for datasets and resources.
  humanURL: https://www.neso.energy/data-portal/api-guidance
  baseURL: https://api.neso.energy/api/3/action
  tags:
  - Metadata
  properties:
  - type: OpenAPI
    url: openapi/neso-metadata-api-openapi.yml
  - type: Documentation
    url: https://www.neso.energy/data-portal
  - type: APIReference
    url: https://www.neso.energy/data-portal/api-guidance
  - type: Licensing
    url: https://www.neso.energy/data-portal/neso-open-licence
  - type: RateLimits
    url: rate-limits/neso-rate-limits.yml
  - type: Authentication
    url: authentication/neso-authentication.yml
  - type: Conventions
    url: conventions/neso-conventions.yml
  - type: ErrorCatalog
    url: errors/neso-error-codes.yml
  - type: DataModel
    url: data-model/neso-data-model.yml
- aid: neso:neso-search-api
  name: National Energy System Operator (NESO) Search API
  description: Search endpoints for datasets and resources.
  humanURL: https://www.neso.energy/data-portal/api-guidance
  baseURL: https://api.neso.energy/api/3/action
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/neso-search-api-openapi.yml
  - type: Documentation
    url: https://www.neso.energy/data-portal
  - type: APIReference
    url: https://www.neso.energy/data-portal/api-guidance
  - type: Licensing
    url: https://www.neso.energy/data-portal/neso-open-licence
  - type: RateLimits
    url: rate-limits/neso-rate-limits.yml
  - type: Authentication
    url: authentication/neso-authentication.yml
  - type: Conventions
    url: conventions/neso-conventions.yml
  - type: ErrorCatalog
    url: errors/neso-error-codes.yml
  - type: DataModel
    url: data-model/neso-data-model.yml
common:
- type: CapabilityMap
  url: capabilities/neso-capability-edges.yml
  name: National Energy System Operator (NESO) Business Capability Map
- type: IssueTracker
  url: https://github.com/carbon-intensity/api-definitions/issues
- type: VulnerabilityDisclosure
  url: security/neso-vulnerability-disclosure.yml
- type: Security
  url: https://www.neso.energy/responsible-disclosure
- type: SecurityTxt
  url: well-known/neso-security.txt
- type: DomainSecurity
  url: security/neso-domain-security.yml
- type: WellKnown
  url: well-known/neso-well-known.yml
- type: Authentication
  url: authentication/neso-authentication.yml
- type: Conventions
  url: conventions/neso-conventions.yml
- type: RateLimits
  url: rate-limits/neso-rate-limits.yml
- type: ErrorCatalog
  url: errors/neso-error-codes.yml
- type: Lifecycle
  url: lifecycle/neso-lifecycle.yml
- type: Conformance
  url: conformance/neso-conformance.yml
- type: DataModel
  url: data-model/neso-data-model.yml
- type: Packages
  url: packages/neso-packages.yml
- type: X-MCPServerCandidate
  url: mcp/neso-mcp.yml
  note: 'Renamed from MCPServer 2026-09-03 (roadmap#247): the manifest self-describes as status: candidate — a tool list derived from the published API contracts, not an existing server. The scorer already read the manifest and reported mcp_server correctly; the MCPServer type was crediting the artifact-type surfaces with a server that does not exist.'
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/neso-llms.txt
- type: Website
  url: https://www.neso.energy/
- type: Documentation
  url: https://www.neso.energy/data-portal/api-guidance
- type: Portal
  url: https://www.neso.energy/data-portal
- type: APIReference
  url: https://carbon-intensity.github.io/api-definitions/
- type: Licensing
  url: https://www.neso.energy/data-portal/neso-open-licence
- type: TermsOfService
  url: https://www.neso.energy/terms-and-conditions
- type: PrivacyPolicy
  url: https://www.neso.energy/privacy-policy
- type: Support
  url: https://www.neso.energy/contact-us
- type: GitHubOrganization
  url: https://github.com/carbon-intensity
- type: LinkedIn
  url: https://www.linkedin.com/company/neso-energy
- type: BlogRSS
  url: https://www.neso.energy/rss.xml
- type: News
  url: https://www.neso.energy/news
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com