NZXplorer Companies API
NZX-listed company data (131 issuers)
NZX-listed company data (131 issuers)
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/nzxplorer-co-nz:nzxplorer-co-nz-companies-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: NZXplorer Companies API
version: 1.157.0
description: 'Comprehensive NZX market data, governance intelligence, and proxy advisory API covering 130 issuers on the New Zealand Exchange. Provides structured access to company fundamentals, director intelligence, insider trades, financial statements, ESG data, dividend analytics, proxy advisory reports, and more.
All monetary values in financial statement endpoints (income_statements, balance_sheets, cash_flow_statements, earnings_results) are in NZD thousands unless otherwise noted. Dividends per share (dps_cents) are in cents. Ratios are unit-free percentages.'
contact:
name: NZXplorer API Support
email: hello@nzxplorer.co.nz
url: https://nzxplorer.co.nz/developers
license:
name: Proprietary
url: https://nzxplorer.co.nz/terms
x-logo:
url: https://nzxplorer.co.nz/logo.png
servers:
- url: https://nzxplorer.co.nz/api/v1
description: Production
security:
- ApiKeyHeader: []
- ApiKeyQuery: []
tags:
- name: Companies
description: NZX-listed company data (131 issuers)
paths:
/companies:
get:
operationId: listCompanies
summary: List Companies
description: Browse all 131 NZX-listed companies with sector filtering and search.
tags:
- Companies
x-tier: free
parameters:
- name: search
in: query
required: false
description: Search by company name or ticker
schema:
type: string
- name: sort
in: query
required: false
description: 'Sort by: ticker, name, sector, market_cap (default: ticker)'
schema:
type: string
- name: order
in: query
required: false
description: 'Sort order: asc or desc (default: asc)'
schema:
type: string
- name: limit
in: query
required: false
description: 'Results per page, max 500 (default: 50)'
schema:
type: integer
- name: offset
in: query
required: false
description: 'Pagination offset (default: 0)'
schema:
type: integer
responses:
'200':
description: List Companies
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/companies/{ticker}:
get:
operationId: getCompany
summary: Company Detail
description: Get detailed company profile with optional directors, financials, governance score, and latest price.
tags:
- Companies
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., AIR, FPH, SPK)
schema:
type: string
- name: include
in: query
required: false
description: 'Comma-separated: directors, financials, governance, price, all'
schema:
type: string
responses:
'200':
description: Company Detail
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/management-team/{ticker}:
get:
operationId: getManagementTeam
summary: Management Team
description: Get the management team (C-suite executives) for an NZX company. Returns current or historical executives with normalized roles, tenure, and linked person profiles.
tags:
- Companies
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., FPH, AIR, SPK)
schema:
type: string
- name: role
in: query
required: false
description: 'Filter by normalized role: CEO, CFO, COO, CTO, CIO, CHRO, CLO, CMO, CSO, COO, COMPANY_SECRETARY, GM, MD, OTHER'
schema:
type: string
- name: current
in: query
required: false
description: If true (default), only current executives. Set to false for full history.
schema:
type: string
enum:
- 'true'
- 'false'
responses:
'200':
description: Management Team
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/executive-compensation/{ticker}:
get:
operationId: getExecutiveCompensation
summary: Executive Compensation
description: CEO/CFO pay — base salary, STI, LTI, total compensation, shares granted.
tags:
- Companies
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
- name: year
in: query
required: false
description: Fiscal year filter
schema:
type: string
responses:
'200':
description: Executive Compensation
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/kiwisaver-holdings/{ticker}:
get:
operationId: getKiwisaverHolding
summary: KiwiSaver Holdings
description: Which KiwiSaver funds hold this NZX stock. 6,872 holdings across 370 funds.
tags:
- Companies
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
responses:
'200':
description: KiwiSaver Holdings
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/company-pager/{ticker}:
get:
operationId: getCompanyPager
summary: Company One-Pager
description: Auto-generated company snapshot with key financial metrics, governance score, dividends, insider activity, risk flags, and recent announcements. Also available as a branded PDF at /api/v1/company-pager/{ticker}/pdf (supports white-label branding via ?branding=partner&logo_url=...&org_name=...).
tags:
- Companies
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., AIR, FPH, SPK)
schema:
type: string
responses:
'200':
description: Company One-Pager
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/corporate-relationships/{ticker}:
get:
operationId: getCorporateRelationship
summary: Corporate Relationships
description: Professional service relationships for an NZX company — auditors (with tenure years and fee breakdown), law firms/solicitors, share registrars, and bankers. Includes shared adviser detection (other NZX companies using the same professional firms) and relationship summary.
tags:
- Companies
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., FPH, AIR, SPK)
schema:
type: string
responses:
'200':
description: Corporate Relationships
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/corporate-giving/{ticker}:
get:
operationId: getCorporateGiving
summary: Corporate Giving
description: Corporate donations, sponsorships, and community investment for an NZX company. Cross-linked to registered charities where possible. Returns recipients, amounts, donation types (cash/sponsorship/community_investment/grant/in-kind), and foundation details.
tags:
- Companies
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., CEN, MEL, FPH)
schema:
type: string
responses:
'200':
description: Corporate Giving
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/professional-firms/{slug}:
get:
operationId: getProfessionalFirm
summary: Professional Firm Profile
description: Detailed professional services firm profile with full client list. Covers law firms/solicitors, auditors, share registrars, and bankers. Returns firm metadata, current and historical NZX client relationships, and summary statistics.
tags:
- Companies
x-tier: free
parameters:
- name: slug
in: path
required: true
description: Firm URL slug (e.g., chapman-tripp, kpmg, computershare)
schema:
type: string
responses:
'200':
description: Professional Firm Profile
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/company-changes/{ticker}:
get:
operationId: getCompanyChange
summary: Company Material Changes
description: Detect material changes for an NZX company by comparing consecutive announcement extractions. Surfaces revenue, NPAT, EBITDA, EPS, and net debt changes that exceed significance thresholds. Also includes recent board changes and dividend changes.
tags:
- Companies
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g. FPH, AIR)
schema:
type: string
- name: days
in: query
required: false
description: 'Lookback period in days (default: 30)'
schema:
type: integer
responses:
'200':
description: Company Material Changes
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
responses:
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Missing API key
message: Include your API key via X-API-Key header or ?api_key= query parameter.
docs: https://nzxplorer.co.nz/developers
NotFound:
description: Resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InternalError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
RateLimited:
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Rate limit exceeded
message: free tier allows 10 requests/minute.
retry_after_seconds: 45
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
X-RateLimit-Limit:
description: Maximum requests allowed per minute
schema:
type: integer
X-RateLimit-Remaining:
description: Always 0 when rate limited
schema:
type: integer
schemas:
Envelope:
type: object
description: Standard API response envelope
properties:
data:
description: Response payload
meta:
type: object
properties:
api_version:
type: string
example: v1
timestamp:
type: string
format: date-time
format:
type: string
enum:
- standard
- llm
- fdc3
- toon
endpoint:
type: string
ErrorResponse:
type: object
properties:
error:
type: string
description: Error message
message:
type: string
description: Human-readable explanation
nullable: true
docs:
type: string
format: uri
description: Link to API documentation
nullable: true
retry_after_seconds:
type: integer
description: Seconds to wait before retrying (rate limit only)
nullable: true
required:
- error
headers:
RateLimitHeaders:
X-RateLimit-Limit:
description: Maximum requests allowed per minute
schema:
type: integer
X-RateLimit-Remaining:
description: Requests remaining in current window
schema:
type: integer
X-RateLimit-Reset:
description: Unix timestamp when the rate limit window resets
schema:
type: integer
X-RateLimit-Limit-Day:
description: Maximum requests allowed per day
schema:
type: integer
X-RateLimit-Remaining-Day:
description: Requests remaining for today
schema:
type: integer
X-API-Tier:
description: Authenticated API key tier (free, pro, enterprise, institutional)
schema:
type: string
X-Request-ID:
description: Unique request ID (UUID v4) for support correlation
schema:
type: string
format: uuid
securitySchemes:
ApiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: API key passed via the X-API-Key header
ApiKeyQuery:
type: apiKey
in: query
name: api_key
description: API key passed as a query parameter