Free public API
Every NZ school has a JSON and a Markdown endpoint with the full source-linked record. Built for AI search engines, researchers, journalists and parents who want machine-readable data.
Endpoints
GET /api/school/{slug}/facts.json Full JSON record: identity, ERO trajectory, audited financials, leadership, statutory-manager status, international programme, tags, feeder relationships. Every fact carries source_url and source_doc_date.
GET /api/school/{slug}/markdown.md Same record, rendered as LLM-friendly Markdown. Includes citation links inline.
GET /api/regions.json Aggregate counts + canonical slugs for NZ's 16 regions (school count, total roll, average EQI, by-type + by-authority breakdowns). Powers the geographic taxonomy in /rankings + /regions.
GET /api/methodology.json Machine-readable data provenance + freshness manifest. Source catalogue, refresh cadence, licensing terms, snapshot timestamp. Sibling pointers to every other endpoint.
GET /api/schema.json JSON Schema (draft-07) for the per-school facts.json contract. Lets clients validate without round-tripping a sample.
GET /llms.txt · /llms-full.txt Compact index (top pages + per-school facts endpoints) and full-content index (every per-school endpoint) for AI crawlers per the llms.txt convention.
POST /mcp Model Context Protocol JSON-RPC 2.0 server for Claude, ChatGPT and any MCP-compatible client. See install instructions.
Snapshot
Current snapshot: 2,576 schools · 8,068 ERO reports · 1,398 audited financials · 11,100 tags · 12,492 leadership records.
Generated 12 Jul 2026, 12:34 pm.
Limits
- Free tier: rate-limited at the CDN; intended for AI search engines, research and small projects.
- No authentication required for read endpoints.
- Commercial / high-volume use requires a Pro or Enterprise plan — see data partners.
Terms
You may consume the API for non-commercial AI search, research and reporting. You may not scrape and re-publish our derived data (scores, tags, trajectory diffs, aggregated indexes) without a licence. See terms.