Public API · v1

Small, read-only employer lookups.

Use the API for a single NZBN lookup or a bounded employer-name search. No account or API key is required.

OpenAPI 3.1 ↗Bulk snapshots

Endpoints

Two routes. No writes.

GET · HEAD

Find by NZBN

https://nzaei.zemo.bio/api/public/v1/employers/{nzbn}

Returns one public employer record for an exact 13-digit New Zealand Business Number.

GET · HEAD

Search by name

https://nzaei.zemo.bio/api/public/v1/employers/search?q={query}&limit={1..10}

Searches legal and trading names. Every keyword must match; results are capped at 10.

Quick start

Use standard HTTP.

No authentication header and no request body are needed.

curl --get \
  --data-urlencode 'q=One New Zealand' \
  --data-urlencode 'limit=5' \
  'https://nzaei.zemo.bio/api/public/v1/employers/search'

Operating rules

Built for polite integrations.

Rate limit: 10 requests per 10 seconds per IP address at a Cloudflare location. A rejected request returns 429 and Retry-After: 10.
Response contract: Successful responses use data. Search adds meta.query and meta.count. Errors include a stable error.code and meta.requestId.
Caching: Successful results are cacheable for 60 seconds in clients and 5 minutes at the edge.
Bulk data: For imports or full-dataset work, use the dated, checksummed CSV snapshots rather than paginating or crawling the API.

Data boundaries

Public facts, carefully framed.

The API excludes platform identities, community associations, installation identifiers, refresh controls, and all write operations. Records are dated observations, not a live or complete official register. Verify important decisions with Immigration New Zealand or the employer.