Can I filter by status?

The request accepts an optional status filter, alongside keyword, max_items and start_page.

Do I pay for lookups that come back empty?

No. You are charged per result, so a request that finds nothing costs nothing. Testing this against a messy list is free to get wrong.

What does a lookup cost?

1 point per returned record, which is $1 per 1,000, and only records that come back are charged. Points come out of your monthly plan allowance, so there is no separate per-country contract.

Corporate registry

New Zealand Company Search API and MCP — Find a Company Number by Name

Send a company name and get the matching New Zealand companies back with their company number, NZBN, name, status, registered address, company type, incorporation date and a link to the register record.

Run it in the app Read the API docs

You send: A company name
You get back: Matching companies with company number, NZBN, name, status, address and record link
Coverage: New Zealand — entities on Companies Register.
Price: 1 point per returned record — $1 per 1,000; Billed per record actually returned, capped by max_items. A request that returns nothing costs nothing.

Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

Approach	What it takes	Cost	Trade-off
Companies Register directly	Type the name into Companies Register and read the results	Usually free, sometimes per-document	A different interface, language and data shape for every country you add
Collecting it yourself	Build and host a crawler per register, then keep each one alive	Infrastructure and maintenance	Registers change their pages without warning, and nobody is on the hook when yours breaks
NeuralVerge	One request, the same shape as every other source in the catalog	$1 per 1,000, misses not billed	Covers New Zealand — other countries are separate sources with the same request format

Response

What you get back

Every field in the example response below.

Field	Type	Description
`session_id`	string	Identifier of this run. Keep it to trace the call.
`kind`	string	Source that produced the response.
`keyword`	string	The search text you sent.
`max_items`	number	The cap on returned records.
`start_page`	number	The results page the run started from.
`partial`	boolean	True when the run stopped before reading everything it was asked for.
`human`	string	Readable summary of the run in Markdown, including how many results were found.
`machine.total_items`	number	Number of records returned in this response.
`machine.first_item`	object	The first returned record, repeated as the first entry of items.
`machine.first_item.registration_number`	string	The New Zealand company number.
`machine.first_item.nzbn`	string	New Zealand Business Number.
`machine.first_item.name`	string	Registered company name.
`machine.first_item.status`	string	Company status, for example Registered.
`machine.first_item.address`	string	Registered address as one line.
`machine.first_item.url`	string	Link to the Companies Register record.
`machine.first_item.company_type`	string	Company type, for example NZ Limited Company.
`machine.first_item.incorporation_date`	string	Incorporation date, as YYYY-MM-DD.
`machine.items`	array	Every returned record, each with the same fields as first_item.
`machine.total_found`	number	How many matches the register reports in total, which can be more than you asked for.
`machine.page_count`	number	Number of result pages read.
`machine.blocked`	boolean	Whether the register refused the read. False in the sample.
`machine.proxy_traffic_bytes`	number	Traffic used by the run, in bytes. Informational.
`total_points`	number	Points charged for the run, one per returned record.

Response

Example response

A real response, as returned.

{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "nz_companies_search",
  "keyword": "fonterra",
  "max_items": 2,
  "start_page": 1,
  "partial": false,
  "human": "# New Zealand — Companies Register — company search\n\n- **Keyword:** fonterra\n- **Results:** 2 of 56 found\n- **Proxy traffic:** 267.8 KB",
  "machine": {
    "total_items": 2,
    "first_item": {
      "registration_number": "1157956",
      "nzbn": "9429036794195",
      "name": "FONTERRA TM LIMITED",
      "status": "Registered",
      "address": "109 Fanshawe Street, Auckland, 1010, New Zealand",
      "url": "https://app.companiesoffice.govt.nz/co/1157956",
      "company_type": "NZ Limited Company",
      "incorporation_date": "2001-08-21"
    },
    "items": [
      {
        "registration_number": "1157956",
        "nzbn": "9429036794195",
        "name": "FONTERRA TM LIMITED",
        "status": "Registered",
        "address": "109 Fanshawe Street, Auckland, 1010, New Zealand",
        "url": "https://app.companiesoffice.govt.nz/co/1157956",
        "company_type": "NZ Limited Company",
        "incorporation_date": "2001-08-21"
      },
      {
        "registration_number": "1118347",
        "nzbn": "9429036995356",
        "name": "FONTERRA (MIDDLE EAST) LIMITED",
        "status": "Registered",
        "address": "109 Fanshawe Street, Auckland Central, Auckland, 1010, New Zealand",
        "url": "https://app.companiesoffice.govt.nz/co/1118347",
        "company_type": "NZ Limited Company",
        "incorporation_date": "2001-02-23"
      }
    ],
    "total_found": 56,
    "page_count": 1,
    "blocked": false,
    "proxy_traffic_bytes": 274238
  },
  "total_points": 2
}

Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

Results come back in the same envelope as every other source: a session id, a readable summary, the structured result and the points charged.

curl -X POST https://api.neuralverge.ai/functions/v1/run-nz-companies-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"fonterra","max_items":2}'

Use cases

What teams use it for

Where this field shows up in an actual workflow.

Name to company number

Find the number you need for a company lookup.

Listing a group's companies

Search a brand name and see the entities that carry it.

Matching customer lists

Check names against the register and keep the NZBN.

Checking status

See at once whether the companies matching a name are registered.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

New Zealand — entities on Companies Register.

Freshness

Read at request time, so the answer reflects the register as it stands when you ask.

Handling

Companies Register is a public register. Every response carries the source URL it was read from and a session id you can trace.

What it will not do

—Results show matches by name only, with no directors or shareholders; use the company lookup for those.
—A common word in a name can match many companies, so use max_items and start_page to page through them.
—Each result shows the status the register gives it, so check it before treating a match as a live company.

FAQ

Questions, answered

Yes, each result carries both the company number and the NZBN.

Related sources

New Zealand company

Full record with directors, shareholders and holding company.

New Zealand company documents

Documents filed by the company.

All corporate registries

Company registers across Europe, the Americas and Asia-Pacific, plus global LEI lookup.

Try new zealand company search on your own data

One request format across every source in the catalog.

Get started