UK NHS Provider Reference Records — NHS ODS

Keyless. Pay per record. The official register of incorporated NHS-connected organisations and sites — ODS code, status, role, change date.

This actor turns the NHS England Organisation Data Service (ODS) organisation register into clean, per-record data — the official register of NHS-connected organisations and sites in the UK, at organisation grain. Each run reads the keyless NHS ODS ORD API (directory.spineservices.nhs.uk) and delivers one row per organisation, structured for reference-data, master-data, and healthcare-organisation analysis, reusable with acknowledgement of the source, with no personal data of any kind.

What this is, in one paragraph

The NHS England Organisation Data Service (ODS) maintains the authoritative register of organisations connected to NHS systems — trusts and their sites, pharmacies, dental practices, commissioning bodies, and more — each with a unique ODS code. This actor reads the keyless ODS ORD API and delivers one record per ORGANISATION for the role you select: the ODS code, organisation name, status, record class, primary role (id + description), post code, last-change date, and the ODS org link. It is the ORGANISATION register ONLY — a reference/master-data source about incorporated bodies and sites, never a directory of people.

Who buys this and for what job

• Master-data and reference-data teams resolving NHS organisations to their ODS codes
• Healthcare-analytics teams mapping the NHS organisation landscape by role and status
• Integration engineers who need a clean, keyless ODS organisation feed
• Data engineers who want the NHS ODS organisation table as clean rows from a keyless source.

Open Government Licence v3.0 — reuse with attribution

One licence rider travels on every record. This is public sector information from the NHS England Organisation Data Service (ODS), licensed under the Open Government Licence v3.0: you are free to copy, publish, distribute, adapt, and exploit it commercially and non-commercially, provided you acknowledge the source with the required attribution. These are reported organisation-register facts as published — not an endorsement or a clinical/quality verdict about any organisation.

Organisation grain — no person data, by design

The unit of every record is an incorporated organisation or site — a body, never a person. This actor reads ONLY the ODS list endpoint's organisation fields; the single-organisation detail endpoint that carries contact details is NEVER called. No practitioner, contact, email, phone, or named-individual field is read or emitted — the org/person separation is structural, not a filter. A person-key guard runs on every record as a backstop. This is the org register; it is never provider-people.

Pricing

Event	Free plan	Bronze	Silver	Gold / Platinum / Diamond
nhs_org_record	$0.05	$0.045	$0.04	$0.0335

Delivered before charged. Blocked runs and empty results cost nothing.

Input

Field	Type	Default	Description
primaryRoleId	string	RO198	Required. ODS primary role code to partition the register (e.g. RO198 = NHS TRUST SITE, RO182 = PHARMACY, RO110 = GENERAL DENTAL PRACTICE).
status	string	Active	Organisation status: Active or Inactive.
maxRecords	integer	500	Ceiling on records delivered and billed.

Output

One JSON object per organisation. Real example (values as reported):

{
  "record_id": "RTG",
  "ods_code": "RTG",
  "org_name": "DERBY TEACHING HOSPITALS NHS FOUNDATION TRUST",
  "status": "Active",
  "record_class": "RC1",
  "primary_role_id": "RO198",
  "primary_role_description": "NHS TRUST SITE",
  "post_code": "DE22 3NE",
  "last_change_date": "2021-03-01",
  "org_link": "https://directory.spineservices.nhs.uk/ORD/2-0-0/organisations/RTG",
  "source": "NHS England Organisation Data Service (ODS) \u2014 organisation register",
  "source_url": "https://directory.spineservices.nhs.uk/ORD/2-0-0/organisations",
  "observed_at": "2026-08-25T00:00:00Z"
}

An unbilled RUN_RECEIPT records the door check, the filters, rows seen and delivered, and whether charged equals delivered.

Field reference

Each record is one organisation. Identity: record_id (= ODS code), ods_code, and org_name. Register facts: status, record_class, primary_role_id, primary_role_description, post_code, last_change_date, and org_link. Provenance travels on every record: source, source_url, licence, attribution, disclaimer, and observed_at.

How a run works

A run first re-reads the source host's robots posture from your runtime and stops at the door if that ever changes. It pages the NHS ODS organisation source, and flattens each row to one record — carrying every value and label verbatim, never anything person-shaped — delivered before it is charged, so a blocked or empty run costs you nothing. The actor stops at your maxRecords ceiling and records charge_equals_delivered in the receipt.

Coverage and scope

The ODS register holds hundreds of thousands of organisations across all roles (over 217,000 active). Because it is large, this actor requires a primaryRoleId partition — every run pulls one role (e.g. RO198 = NHS TRUST SITE, ~38k; RO182 = PHARMACY, ~11k), optionally filtered by status, up to your maxRecords ceiling. Pull one role, or sweep roles to build the full register.

Working with the data

The register is master data, and the fields make it joinable. Because every record carries the ods_code and primary_role_description, an analyst can resolve any NHS organisation to its canonical code, filter a role to Active bodies, and track register changes via last_change_date. The record_class separates incorporated organisations (RC1) from sites (RC2), so the organisational hierarchy stays legible.

Identifiers and joins

Every record carries the ods_code — the UK's canonical identifier for NHS-connected organisations — so this feed keys directly into any dataset that references ODS codes (prescribing, activity, commissioning), acting as the reference/master-data spine.

An organisation register, never a people directory

The ODS API exposes two very different things: an ORGANISATION list (codes, names, roles, status) and a per-organisation DETAIL record that can include contact points. This actor is built on the organisation list ONLY, and never calls the detail endpoint, so no contact or named-individual data can enter the output. That separation is deliberate and structural: the product is the incorporated-organisation register — the ODS spine other datasets join to — and it is never a directory of practitioners or people.

Cost guidance

One nhs_org_record per delivered row: cost = rows delivered × your plan's per-record price. 1,000 rows is $50 (Free) / $33.50 (Gold).

Honest limitations

• As reported. Values, labels, and flags are as filed; this actor reformats, it does not audit or recompute.
• A label, not a verdict. These are reported register facts, not an endorsement or a clinical/quality verdict about any organisation.
• Acknowledge the source. The acknowledgement travels on every record.
• No person data of any kind.

Differentiation

This is a net-new category for the NexGenData fleet. It is distinct from any provider-people or practitioner directory — this cell is the ODS ORGANISATION register (incorporated bodies and sites), delivered at organisation grain with no person data by structural design. Its specific job is the NHS ODS organisation register, by role.

The NexGen Signal family

Part of the NexGen Signal family of pay-per-record data products:

• EU Plant Desulphurisation Records — EEA IED
• EU Industrial Secondary Activity Records — EEA IED
• UK Company Status Records
• Higher Education Institution Records
• US Hospital Ownership Records

Source: NHS England Organisation Data Service (ODS), ORD API (directory.spineservices.nhs.uk). Public sector information licensed under the Open Government Licence v3.0; attribution required. Organisation grain only; the detail endpoint with contacts is never called; no practitioner/contact/named-individual field selected or emitted. No natural-person data of any kind. Values and labels as filed, not a verdict.