git:20260702.233bc94 to git:20260719.1748a98

22 added, 1 removed. Audit A to A.

---

name: class4-grants-nz

- description: Query New Zealand Class 4 gambling grants and Granted.govt.nz public data from DIA/data.govt.nz. Use when the task involves pokie-machine grant funding, gaming-machine profits, grant recipients, Class 4 societies/funders, grant categories, regional/TLA grant totals, accepted or declined grant applications, or discovering the related venues and gaming-machine quarterly datasets. Read-only and no API key required.

+ description: "Query New Zealand Class 4 gambling grants and Granted.govt.nz public data from DIA/data.govt.nz. Use when the task involves pokie-machine grant funding, gaming-machine profits, grant recipients, Class 4 societies/funders, grant categories, regional/TLA grant totals, accepted or declined grant applications, or discovering the related venues and gaming-machine quarterly datasets. Read-only and no API key required."

+ license: MIT

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

+ metadata:

+ thecolab.category: "public-data"

+ thecolab.source_owner: "Department of Internal Affairs"

+ 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.granted.govt.nz/"

+ thecolab.allowed_domains: "catalogue.data.govt.nz,www.dia.govt.nz,www.granted.govt.nz"

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

+ thecolab.health: "healthy"

+ thecolab.maintainer: "@adam91holt"

---

# Class 4 Grants NZ

## Goal

Query public Department of Internal Affairs Class 4 gambling grants data, the Granted.govt.nz source dataset, and related data.govt.nz discovery metadata through a deterministic no-login CLI.

## Use this when

- A user asks about NZ Class 4 grants, pokie grants, gaming-machine profit grants, or Granted.govt.nz data

- A workflow needs grant rows filtered by year, status, society/funder, recipient, category, region, or territorial local authority

- A user wants top funders, recipients, or grant categories from the Class 4 grants CSV

- A task needs source links for the Class 4 grants dataset, venue/gaming-machine quarterly lists, or DIA society website list

## Do not use this for

- Applying for a grant, logging into society portals, submitting forms, or changing any funding record

- Real-time venue/gaming-machine counts beyond the public quarterly file links

- Legal or regulatory advice about gambling compliance

- Bulk mirroring the full data catalogue beyond the task at hand

## CLI

```bash

python3 skills/class4-grants-nz/scripts/cli.py datasets --json

python3 skills/class4-grants-nz/scripts/cli.py preview --limit 5

python3 skills/class4-grants-nz/scripts/cli.py grants --year 2024 --status Accepted --region Auckland --limit 10 --json

python3 skills/class4-grants-nz/scripts/cli.py funders --year 2024 --limit 10

python3 skills/class4-grants-nz/scripts/cli.py recipients --society "Pub Charity" --limit 10 --json

python3 skills/class4-grants-nz/scripts/cli.py categories --year 2024 --field Category_1

python3 skills/class4-grants-nz/scripts/cli.py society-websites --json

```

Commands:

- `datasets [--json]` - discover the grants CSV and venue/gaming-machine quarterly list datasets from data.govt.nz CKAN

- `preview [--limit N] [--json]` - show the first rows of the Class 4 grants CSV

- `grants [filters] [--limit N] [--json]` - filter grant application rows and report matched totals

- `funders [filters] [--limit N] [--sort FIELD] [--json]` - aggregate by society/funder

- `recipients [filters] [--limit N] [--sort FIELD] [--json]` - aggregate by final recipient organisation

- `categories [filters] [--field Category_1|Category_2] [--limit N] [--json]` - aggregate by grant category

- `society-websites [--limit N] [--json]` - list DIA-published society website links

Shared filters for grants/aggregate commands: `--query`, `--year`, `--status Accepted|Declined`, `--society`, `--recipient`, `--category`, `--region`, and `--tla`.

## Resources

- CLI: `scripts/cli.py`

- Smoke test: `scripts/smoke_test.py`

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