Skip to main content

New Zealand Business Number library

Project description

New Zealand Business Number Python Library

A Python library for interacting with New Zealand Business Number (NZBN) services provided by the New Zealand Ministry of Business, Innovation, and Employment (MBIE).


$ pip install nzbn


The MBIE NZBN API has two main "Entity" types, where "Entity" is used to refer to a legal person recorded in the New Zealand Business Register (NZBR). The firs is included in vector results from search queries, and is called SearchEntity. The second is returned in response to requests for a specific NBZN, and is called FullEntity.

The authors of this library find referring to these as AbbreviatedEntity and Entity to be more natural, and therefore those names are used. You can also use SearchEntity and FullEntity in your Python code, as those names are effectively type-aliases for AbbreviatedEntity and Entity.

Example Usage

Get a list of abbreviated entities

from nzbn import AbbreviatedEntity

entities: List[AbbreviatedEntity] = AbbreviatedEntity.retrieve_many(
    api_key="your nzbn API access token",
    search_text="some entity name",
    page=0,    # defaults to 0
    limit=20   # per page count, defaults to 20

Get detailed data about an entity

from nzbn import Entity

entity: Optional[Entity] = Entity.retrieve(
    api_key="your nzbn API access token",
    sandbox=False  # defaults to False

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nzbn-1.0.0.tar.gz (11.2 kB view hashes)

Uploaded source

Built Distribution

nzbn-1.0.0-py3-none-any.whl (16.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page