Support centre

NZBN API version 4

Last Updated: Aug 07, 2019 02:39PM NZST

Updated 7 August 2019

New NZBN API version 4 now available

The new NZBN API version "v4" is now live and full documentation is available in MBIE’s API Explorer.  The new version includes updates that respond to recent developments in the NZBN that allow for new Primary Business Data elements, including GST numbers for businesses.  We’ve also used this opportunity to make enhancements to functionality in response to customer feedback on v3.


Key changes in v4

  • New Primary Business Data (PBD) elements
  • Multiple values of some data elements now supported for companies
  • Ability to retrieve specific data
  • Improved business change information
  • Improvements to watchlist functionality


What this means for existing users of v3

When the new version is available for public use all current v3 users will have access without having to resubscribe to v4.


Version 3 will continue to be available for the foreseeable future and existing users will not need to immediately migrate to the new version when it becomes available.


Data structures and most key operations in v4 are significantly unchanged from v3 to make it easier to migrate to the new version and take advantage of the new features. Changes to the legislation on NZBN Primary Business Data mean that some features do not have backwards compatibility.

Contact us

Call us

  • 0800 624 301
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found