nz-companies-officelisted
Install: claude install-skill techhorizonlabs/gearlist
# New Zealand Companies Office and NZBN
A New Zealand business's record in the NZBN Register, found by NZBN, name or company number through MBIE's NZBN API (version 5).
MBIE's page for the Companies API says: "To search and get details of New Zealand companies and other business types subscribe to the NZBN API instead." The NZBN Register holds all companies and other entity types from the Companies Office registers, all public sector entities, and the sole traders, partnerships and trusts that have chosen to register for an NZBN.
`scripts/nzbn_lookup.py` makes the calls below and prints Markdown, or JSON with `--json`. It uses the Python 3 standard library only, sends read-only GET requests and writes nothing to disk.
## Sign-in: a subscription key
MBIE says there is no fee for the NZBN API. Access still takes paperwork:
1. The human's organisation signs MBIE's API Access Agreement (MBIE's latest copy is from November 2022) and emails it to MBIE's API support team.
2. They log in at https://portal.api.business.govt.nz/, request a subscription to the NZBN product, and wait for approval. MBIE's support team may ask for more information first.
3. Once approved, they generate a production subscription key. For searching and viewing public data, MBIE says the subscription key is all that is needed.
4. The key lives in the `NZBN_SUBSCRIPTION_KEY` environment variable. The script reads it from there and nowhere else, and sends it in the `Ocp-Apim-Subscription-Key` header, so i