git:20260708.207c804 to git:20260719.1748a98

22 added, 1 removed. Audit A to A.

---

name: healthcert-rest-homes-nz

- description: Query Ministry of Health certified aged-care rest-home provider data, facility pages, audit-report links, and certification caveats. Use when the task involves NZ rest-home certification, aged-care provider beds, legal entities, auditors, certificate end dates, audit report metadata, corrective-action page availability, or source caveats for bot-protected Ministry facility pages.

+ description: "Query Ministry of Health certified aged-care rest-home provider data, facility pages, audit-report links, and certification caveats. Use when the task involves NZ rest-home certification, aged-care provider beds, legal entities, auditors, certificate end dates, audit report metadata, corrective-action page availability, or source caveats for bot-protected Ministry facility pages."

+ license: MIT

+ compatibility: "Requires Python 3.10+ and network access for live data"

+ metadata:

+ thecolab.category: "property"

+ thecolab.source_owner: "Ministry of Health"

+ thecolab.source_type: "official"

+ thecolab.auth: "none"

+ thecolab.access_mode: "public-api"

+ thecolab.data_class: "public"

+ thecolab.writes: "false"

+ thecolab.browser: "false"

+ thecolab.risk: "low"

+ thecolab.cache_ttl: "24h"

+ thecolab.schema_version: "1"

+ thecolab.skill_type: "public-api"

+ thecolab.pack: "nz-public-data"

+ thecolab.source_url: "https://www.health.govt.nz/system/files/LegalEntitySummaryAgedCare.csv"

+ thecolab.allowed_domains: "www.health.govt.nz"

+ thecolab.last_verified: "2026-07-19"

+ thecolab.health: "healthy"

+ thecolab.maintainer: "@adam91holt"

---

# HealthCert Rest Homes NZ

## Goal

Use a read-only CLI to inspect public Ministry of Health certified aged-care rest-home data and facility audit metadata.

## Use This When

- A user asks for certified New Zealand rest homes, aged-care facilities, bed counts, auditors, or legal provider names

- A workflow needs a respectful sample of Ministry certified-provider CSV rows by legal provider

- A user needs public Ministry facility page details or audit report links for one rest home

- A user needs clear blocked-source caveats for Ministry pages that return Cloudflare or edge-protection responses

## Do Not Use This For

- Bulk mirroring audit PDFs/DOCX files

- Private resident records, clinical records, complaints, or non-public certification data

- HealthCERT write actions, provider registration, or authenticated Ministry systems

- Inferring risk ratings or corrective-action status when the public page is blocked or does not publish those rows

## Preferred Workflow

1. Run `scripts/cli.py list --json` to fetch and filter the official certified aged-care CSV.

2. Use `sample --provider "Legal name" --json` for a small provider-level aggregation sample.

3. Use `facility "Premises name" --json` to fetch the public Ministry facility page when reachable.

4. Use `reports "Premises name" --json` to list public audit report links without downloading the documents.

5. If a facility page is blocked, report the returned `blocked` status, `source_url`, and the CSV fallback row instead of treating the facility as missing.

## CLI

Run with:

```bash

python3 skills/healthcert-rest-homes-nz/scripts/cli.py <command> [flags]

```

Commands:

- `list [--query TEXT] [--city CITY] [--provider NAME] [--limit N] [--json]` - fetch and filter the certified aged-care CSV

- `facility <slug-or-name> [--json]` - fetch one public facility page and return premise/provider/certification details when reachable

- `reports <slug-or-name> [--json]` - list public audit report links for one facility page

- `sample --provider NAME [--limit N] [--json]` - return a small provider-level CSV sample and summary totals

## Resources

- CLI entrypoint: `scripts/cli.py`

- Smoke test: `scripts/smoke_test.py`

- Source notes and caveats: `references/api-notes.md`

## Notes

- The CLI is read-only, keyless, and uses Python standard library modules plus the repo-local `lib/nzfetch.py` helper.

- The official CSV is the primary structured source for list/sample commands.

- Facility pages may return HTTP 403 to automated clients. The CLI classifies that as `blocked` and keeps the CSV-derived fallback metadata available.

- Audit report links are listed as metadata only; the skill does not download or parse PDFs/DOCX files.