← ClaudeAtlas

nz-companies-officelisted

Look up a New Zealand business in the NZBN Register by NZBN, name or company number, through MBIE's NZBN API, which the Companies Office points to for company searches. Gives the entity name, NZBN, entity type, status, registration date, company number, trading names, industry code and any GST numbers the business has made public. Needs an NZBN API subscription key in NZBN_SUBSCRIPTION_KEY; there is no fee, but MBIE asks for a signed API Access Agreement. Does not print directors, shareholders or contact details. Use when asked to check a New Zealand company or business, look up an NZBN or NZ company number, or find out whether a New Zealand business is registered.
techhorizonlabs/gearlist · ★ 2 · AI & Automation · score 58
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