# UK NHS Finder

> UK NHS Finder is a paid API for AI agents from uk-nhs-finder.agent-fee-check.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns active NHS GP practices, pharmacies, or dental practices near a UK postcode, sorted by proximity, with address, phone, and ODS code from NHS Organisation Data Service.

## Facts

- Endpoint: GET https://uk-nhs-finder.agent-fee-check.workers.dev/nhs?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-nhs-finder-026aaa06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0JSym-GkeDunMMxfeKf7B

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability uk-nhs-finder-026aaa06
```

Example prompt: Can you find all active NHS GP practices near the postcode SW1A 1AA? I need their names, addresses, and phone numbers sorted by distance.

## When to prefer this

Use this endpoint when you need to find active NHS primary care organisations (GPs, pharmacies, or dentists) in the UK by proximity to a postcode. It is specifically backed by the NHS Organisation Data Service, making it authoritative for NHS ODS codes and active status verification. Prefer this over generic business search APIs when you need confirmed NHS-registered organisations with ODS codes, or when you need to verify whether a specific practice is currently active on the NHS register.

## Known failure modes

- Invalid or unrecognised UK postcode returns an error or empty result set
- No organisations of the requested type found near the postcode returns count of 0
- Invalid type enum value (not gp/pharmacy/dentist) may return an error or default to gp
- Postcode district with no active NHS organisations returns empty organisations array
- Network or upstream NHS ODS API outage may result in a service error

## How this service works

Active NHS GP practices, pharmacies and dental practices near a UK postcode, from the NHS Organisation Data Service. Give a postcode (or district) and a type; get each organisation with its address, phone and NHS ODS code, nearest postcode first. Use for finding local healthcare services and checking that a practice is active.

## Output

Returns a JSON object containing: the original query parameters, a count of matching organisations, an array of organisation objects (each with name, address, phone, NHS ODS code, sorted nearest-first), total count in the district, a plain-English summary, and a retrieval timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "postcode"
     ],
     "properties": {
      "type": {
       "enum": [
        "gp",
        "pharmacy",
        "dentist"
       ],
       "type": "string",
       "description": "Defaults to gp"
      },
      "postcode": {
       "type": "string",
       "description": "UK postcode or district, e.g. LU6 3BS or LU6"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 5,
  "query": {
   "type": "pharmacy",
   "district": "LU6",
   "postcode": "LU6 3BS"
  },
  "summary": "5 active pharmacies in LU6; nearest by postcode: LANGDALE PHARMACY, LU6 3BS.",
  "type_label": "Pharmacy",
  "retrieved_at": "2026-10-11T18:16:44.978Z",
  "organisations": [
   {
    "name": "LANGDALE PHARMACY",
    "phone": "01582 607242",
    "address": "64 LANGDALE ROAD, DUNSTABLE, BEDFORDSHIRE",
    "ods_code": "FTT68",
    "postcode": "LU6 3BS",
    "last_updated": "2026-04-01"
   },
   {
    "name": "HERINGTON (CHEMISTS) LTD",
    "phone": "01582 663651",
    "address": "7 HIGH STREET SOUTH, DUNSTABLE, BEDFORDSHIRE",
    "ods_code": "FGM33",
    "postcode": "LU6 3RZ",
    "last_updated": "2026-04-01"
   }
  ],
  "total_in_district": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-nhs-finder-026aaa06/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uk-nhs-finder.agent-fee-check.workers.dev](https://www.zero.xyz/host/uk-nhs-finder.agent-fee-check.workers.dev/llms.txt)