NZXplorer Financials API
Financial statements, metrics, ratios, and xBRL
Financial statements, metrics, ratios, and xBRL
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-financials-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 Financials 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: Financials
description: Financial statements, metrics, ratios, and xBRL
paths:
/financials/{ticker}:
get:
operationId: getFinancial
summary: Financial Statements
description: Income statements, balance sheets, cash flows, and financial ratios. 367 company-years, FY2010-2025.
tags:
- Financials
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
- name: statement
in: query
required: false
description: 'Filter: income, balance, cashflow, ratios (comma-separated)'
schema:
type: string
- name: period
in: query
required: false
description: 'Filter by period type: annual or interim (default: both)'
schema:
type: string
responses:
'200':
description: Financial Statements
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'
/income-statement/{ticker}:
get:
operationId: getIncomeStatement
summary: Income Statement
description: Dedicated income statement endpoint. Revenue, COGS, gross profit, EBITDA, EBIT, net profit, EPS, DPS. All monetary values in NZD thousands.
tags:
- Financials
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
- name: period
in: query
required: false
description: 'Filter: annual or interim'
schema:
type: string
responses:
'200':
description: Income Statement
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'
/balance-sheet/{ticker}:
get:
operationId: getBalanceSheet
summary: Balance Sheet
description: Dedicated balance sheet endpoint. Assets, liabilities, equity, cash, debt, receivables, inventories, PPE, goodwill. All monetary values in NZD thousands.
tags:
- Financials
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
- name: period
in: query
required: false
description: 'Filter: annual or interim'
schema:
type: string
responses:
'200':
description: Balance Sheet
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'
/cash-flow/{ticker}:
get:
operationId: getCashFlow
summary: Cash Flow Statement
description: Dedicated cash flow endpoint. Operating, investing, financing cash flows, free cash flow, capex. All monetary values in NZD thousands.
tags:
- Financials
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
- name: period
in: query
required: false
description: 'Filter: annual or interim'
schema:
type: string
responses:
'200':
description: Cash Flow Statement
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'
/financials/{ticker}/xbrl:
get:
operationId: getFinancialXbrl
summary: iXBRL Financial Statements
description: Machine-readable Inline XBRL (iXBRL) financial documents. 54 IFRS taxonomy concepts across income statements, balance sheets, cash flows, and ratios. 116 companies, FY2010-2025.
tags:
- Financials
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 (default: latest)'
schema:
type: string
- name: format
in: query
required: false
description: 'Output format: html (iXBRL document), json (structured facts), llm (token-optimized)'
schema:
type: string
responses:
'200':
description: iXBRL Financial Statements
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'
/metrics:
get:
operationId: listMetrics
summary: Financial Metrics
description: 41 financial ratios across profitability, leverage, cash flow, dividends, growth, valuation. List or per-ticker detail.
tags:
- Financials
x-tier: free
parameters:
- name: sector
in: query
required: false
description: Filter by sector
schema:
type: string
- name: sort
in: query
required: false
description: Sort by any ratio (e.g., pe_ratio, roe, dividend_yield)
schema:
type: string
- name: order
in: query
required: false
description: 'Sort direction: asc or desc'
schema:
type: string
- name: year
in: query
required: false
description: Fiscal year or range
schema:
type: string
responses:
'200':
description: Financial Metrics
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'
/metrics/{ticker}:
get:
operationId: getMetric
summary: Metrics Detail
description: Detailed financial metrics for a company — snapshot with live valuation, or full historical mode.
tags:
- Financials
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 or range
schema:
type: string
responses:
'200':
description: Metrics 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'
/accounting-quality/{ticker}:
get:
operationId: getAccountingQuality
summary: Accounting Quality Scores
description: Accounting quality analysis for an NZX company. Includes Beneish M-score (earnings manipulation probability), Piotroski F-score (financial strength 0-9), Altman Z-score (bankruptcy risk), interest coverage ratio, and current ratio. 129 issuers scored.
tags:
- Financials
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., "FPH", "AIR")
schema:
type: string
responses:
'200':
description: Accounting Quality Scores
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