The New Zealand Companies Office API has recently been updated to Version 5 and I have updated NZBN gem

Simple and fast authenticating API wrapper for the New Zealand Companies Office. Full functionality to search by company name, company number and director.

Installation

Add this line to your application’s Gemfile:

gem 'nzbn'

And then execute:

$ bundle

Or install it yourself as:

$ gem install nzbn

You will also need to set the following ENV variables in order to access the API. These can be found on the business.govt.nz website under your login.

$ NZBN_KEY =

Usage

Two functions have been exposed, as per below.

Company details by NZBN

	NZBN.entity(nzbn)

Full company details based on a unique ‘Company Number’ (nzbn) will be returned.

Search for a Company

	NZBN.entities(search_term, entity_status, page_length)

Retriece Entity Filings

	NZBN.filings(nzbn)

All output is returned as parsed JSON. Within a rails view it can be quickly navigated with Nokogiri or similar.