Primary role ID
primaryRoleId
Optional
ODS role code for the organisation's primary role (e.g. RO76 = GP practice).
UK NHS Providers Scraper — ODS Organisation Registry
Pricing
from $3.40 / 1,000 provider records
Search the official NHS Organisation Data Service (ODS) registry of UK healthcare providers — GP practices, pharmacies, dentists, NHS trusts, hospices, care homes. Filter by name, postcode, type, status; optional full address/contacts/roles. Official open-data API (OGL v3), no login, no proxies.
ODS code
odsCode
Optional
Official NHS ODS organisation code (e.g. L81008, RA7, FLM49). Present on both search and detail records.
Name
name
Optional
Organisation's registered name.
Status
status
Optional
Registry status, e.g. Active / Inactive.
Primary role ID
primaryRoleId
Optional
ODS role code for the organisation's primary role (e.g. RO76 = GP practice).
Primary role description
primaryRoleDescription
Optional
Human-readable name of primaryRoleId, resolved from the ODS /roles endpoint (best effort — may be empty if that lookup failed).
Postcode
postCode
Optional
UK postcode of the organisation.
Org record class
orgRecordClass
Optional
ODS record class of the organisation (e.g. HSCOrg, HSCSite).
Last change date
lastChangeDate
Optional
ISO date the registry last changed this record. Also the value used to filter onlyNewSinceLastRun delta runs.
Registry link
orgLink
Optional
Direct URL to this organisation's record on the ODS ORD API.
Source
source
Optional
Constant source tag identifying this actor's records: "nhs-ods".
Address line 1
addressLine1
Optional
Detail-mode only (includeDetails=true or mode="detail"): first address line. Empty/absent on plain search-mode rows.
Address line 2
addressLine2
Optional
Detail-mode only: second address line.
Town
town
Optional
Detail-mode only: town/city.
County
county
Optional
Detail-mode only: county.
Country
country
Optional
Detail-mode only: constituent UK country (England/Scotland/Wales/Northern Ireland).
UPRN
uprn
Optional
Detail-mode only: Unique Property Reference Number for the site, when the registry has one.
Latitude
latitude
Optional
Geocoding only (input includeGeo=true): WGS84 latitude of the organisation's postcode, resolved via the free postcodes.io service. null when the postcode can't be geocoded. Absent when includeGeo is off.
Longitude
longitude
Optional
Geocoding only (input includeGeo=true): WGS84 longitude of the organisation's postcode, resolved via the free postcodes.io service. null when the postcode can't be geocoded. Absent when includeGeo is off.
Phone
phone
Optional
Detail-mode only: first "tel" contact value found on the organisation.
Website
website
Optional
Detail-mode only: first "url" contact value found on the organisation.
Roles
roles
Optional
Detail-mode only: every ODS role held by the organisation, each item shaped {id, name, primary, status}.
Relationships
relationships
Optional
Detail-mode only: ODS relationships to other organisations, each item shaped {relTypeId, relTypeName, targetOdsCode, targetName}. targetName is null unless the optional includeRelationshipNames enrichment is on (it resolves each target's name via one extra API call per unique related organisation); the registry itself does not embed the target's display name in the relationship payload.
Operational start date
operationalStart
Optional
Detail-mode only: start date of the organisation's "Operational" period, when the registry publishes one.
Operational end date
operationalEnd
Optional
Detail-mode only: end date of the organisation's "Operational" period, when one is recorded (absent for currently-active orgs).
Legal start date
legalStart
Optional
Detail-mode only: start date of the organisation's "Legal" period, when the registry publishes one.
Legal end date
legalEnd
Optional
Detail-mode only: end date of the organisation's "Legal" period, when one is recorded.
Is new
isNew
Optional
Delta-mode only (input onlyNewSinceLastRun=true): always true when present, flags that this record changed since this Actor's last stored run checkpoint. Absent on normal (non-delta) runs.