# UK Data API – NHS Healthcare Finder

> UK Data API – NHS Healthcare Finder is a paid API for AI agents from uk-data.agent-fee-check.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-28).

Returns a list of NHS GPs, pharmacies, or dentists near a given UK postcode or district, sourced from official NHS data

## Facts

- Endpoint: GET https://uk-data.agent-fee-check.workers.dev/nhs?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-data-api-nhs-healthcare-finder-7aee6081
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yDUqCLER854SnhzxaIwPB

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-data-api-nhs-healthcare-finder-7aee6081
```

Example prompt: Can you find all pharmacies in the LU6 postcode district in the UK?

## When to prefer this

Use this endpoint when you need official NHS-sourced lists of GPs, pharmacies, or dentists near a UK postcode or district. It aggregates NHS ODS data into a single structured call with attribution included, making it ideal for agents that need to surface local healthcare options without scraping multiple NHS pages. Prefer this over generic search when you need structured, authoritative data with ODS codes and contact details.

## Known failure modes

- Invalid or unrecognised UK postcode returns an error
- No providers of the requested type found in the district returns an empty list
- Missing required 'postcode' query parameter returns a validation error
- Payment not provided triggers a 402 response with a free preview of results
- Malformed postcode format may return unexpected results

## How this service works

UK public data for AI agents, one origin, pay per call: a one-call postcode report, street crime, live flood warnings, property sales and the House Price Index, food hygiene ratings, MP lookup, NHS GPs, pharmacies and dentists, Companies House checks and search, UK working days and bank holidays, and the cheapest card machine provider. Official sources, attribution in every answer, free preview in every 402, failed requests never charged.

## Output

Returns a JSON object containing: a count and total of matching NHS organisations in the district, a plain-English summary naming the nearest provider, a list of organisations each with name, phone, address, ODS code, postcode, and last-updated date, plus query echo and 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": "gp (default), pharmacy or dentist"
      },
      "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-data-api-nhs-healthcare-finder-7aee6081/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uk-data.agent-fee-check.workers.dev](https://www.zero.xyz/host/uk-data.agent-fee-check.workers.dev/llms.txt)