Health API Reference
Canonical NHS organisation lookup from nightly ODS reports, excluding named-person registers and patient data.
Search organisations
Returns paginated NHS trusts, trust sites, GP practices, sub-ICB locations and pharmacies for provider directories, validation and organisation linking.
/v1/health/organisations
Waiting for request...
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
name |
string | No | — | Case-insensitive partial name. |
postcode |
string | No | — | Exact postcode; spacing ignored. |
type |
string | No | — | Fixed organisation type. |
status |
string | No | — | open, closed, or dormant. |
parent_code |
string | No | — | Exact parent ODS code. |
page |
integer | No | 1 | One-based page. |
per_page |
integer | No | 25 | 1–100 results. |
curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.govdata.dev/v1/health/organisations?type=nhs_trust&postcode=SE1%207EH"
Net::HTTP.get(URI("https://api.govdata.dev/v1/health/organisations?postcode=SE1%207EH"))
requests.get("https://api.govdata.dev/v1/health/organisations", params={"postcode": "SE1 7EH"}, headers={"Authorization": "Bearer YOUR_API_KEY"})
await fetch("https://api.govdata.dev/v1/health/organisations?postcode=SE1%207EH", {headers: {Authorization: "Bearer YOUR_API_KEY"}})
{"data":[{"ods_code":"RJ1","name":"GUY'S AND ST THOMAS' NHS FOUNDATION TRUST","organisation_type":"nhs_trust","status":"open","open_date":"1993-04-01","close_date":null,"address":{"line_1":"ST THOMAS' HOSPITAL","line_2":"WESTMINSTER BRIDGE ROAD","line_3":null,"town":"LONDON","county":null,"postcode":"SE1 7EH"},"phone":"020 7188 7188","parent_code":null,"region_code":"H","source_report":"etr"}],"meta":{"api_version":"v1","licence":"Open Government Licence v3.0","source":"NHS Organisation Data Service","source_url":"https://digital.nhs.uk/services/organisation-data-service/data-search-and-export/csv-downloads","dataset_updated_at":"2026-08-21T08:36:37Z","latest_open_date":"2026-10-22"},"pagination":{"total":1,"page":1,"per_page":1,"total_pages":1}}
No endpoint-specific 400 or 404 applies to search. Invalid pagination returns 422; no matches return an empty 200 collection.
Get organisation
Returns one organisation by stable, case-insensitive ODS code.
/v1/health/organisations/:ods_code
Waiting for request...
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
ods_code |
string | Yes | — | Stable ODS code. |
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.govdata.dev/v1/health/organisations/RJ1
Net::HTTP.get(URI("https://api.govdata.dev/v1/health/organisations/RJ1"))
requests.get("https://api.govdata.dev/v1/health/organisations/RJ1", headers={"Authorization": "Bearer YOUR_API_KEY"})
await fetch("https://api.govdata.dev/v1/health/organisations/RJ1", {headers: {Authorization: "Bearer YOUR_API_KEY"}})
Response
{"data":{"ods_code":"RJ1","name":"GUY'S AND ST THOMAS' NHS FOUNDATION TRUST","organisation_type":"nhs_trust","status":"open","open_date":"1993-04-01","close_date":null,"address":{"line_1":"ST THOMAS' HOSPITAL","line_2":"WESTMINSTER BRIDGE ROAD","line_3":null,"town":"LONDON","county":null,"postcode":"SE1 7EH"},"phone":"020 7188 7188","parent_code":null,"region_code":"H","source_report":"etr"},"meta":{"api_version":"v1","licence":"Open Government Licence v3.0","source":"NHS Organisation Data Service","source_url":"https://digital.nhs.uk/services/organisation-data-service/data-search-and-export/csv-downloads","dataset_updated_at":"2026-08-21T08:36:37Z","latest_open_date":"2026-10-22"}}
Unknown codes return the standard 404 shape. No endpoint-specific 400 or 422 applies.
Data notes
Principally England and Wales; refreshed nightly after the overnight publication. Open, dormant, and historical closed records are retained. Open Government Licence v3.0. Trust sites are operational codes, not a definitive hospital list. region_code is populated only for the NHS trust report; the same source position means current care organisation in the GP-practice report and is therefore not exposed as a region. Examples were captured locally from genuine ODS rows and must be re-captured after production load.