NZXplorer Stewardship API
Stewardship reports, voting policies, and fund manager votes
Stewardship reports, voting policies, and fund manager votes
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-stewardship-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 Stewardship 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: Stewardship
description: Stewardship reports, voting policies, and fund manager votes
paths:
/stewardship-reports:
get:
operationId: listStewardshipReports
summary: List Stewardship Reports
description: List all FMA-compliant stewardship/voting-record reports for the authenticated user. Each report contains per-company proxy analysis, vote summaries, and category breakdowns. Enterprise tier required.
tags:
- Stewardship
x-tier: free
responses:
'200':
description: List Stewardship Reports
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'
post:
operationId: createStewardshipReports
summary: Generate Stewardship Report
description: Generate a new FMA-compliant stewardship report. Runs the proxy advisory engine across all specified tickers for the given period, producing per-company resolution analysis with vote recommendations. Enterprise tier required.
tags:
- Stewardship
x-tier: free
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
tickers:
type: string
description: Array of NZX ticker symbols (max 100)
policy_id:
type: string
description: 'Voting policy preset ID (default: nzxplorer)'
required:
- tickers
responses:
'200':
description: Generate Stewardship Report
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'
/stewardship-reports/{id}:
get:
operationId: getStewardshipReport
summary: Stewardship Report Detail
description: Get a single stewardship report with full report_data including per-company resolution analysis, vote recommendations, and the policy used. Enterprise tier required.
tags:
- Stewardship
x-tier: free
parameters:
- name: id
in: path
required: true
description: Report ID
schema:
type: string
responses:
'200':
description: Stewardship Report 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'
/stewardship-reports/{id}/pdf:
get:
operationId: getStewardshipReportPdf
summary: Stewardship Report PDF
description: Print-optimized HTML version of a stewardship report. Open in browser and use
tags:
- Stewardship
x-tier: free
parameters:
- name: id
in: path
required: true
description: Report ID
schema:
type: string
responses:
'200':
description: Stewardship Report PDF
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'
/voting-policies:
get:
operationId: listVotingPolicies
summary: List Voting Policies
description: List all custom voting policies for the authenticated user. Policies define threshold overrides for the proxy advisory engine (board independence, remuneration caps, tenure limits, etc.). Enterprise or Institutional tier required.
tags:
- Stewardship
x-tier: free
responses:
'200':
description: List Voting Policies
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'
post:
operationId: createVotingPolicies
summary: Create Voting Policy
description: Create a new custom voting policy with threshold overrides. The policy JSONB must include at minimum board_independence_min (number). Optionally set base_preset to inherit defaults from a built-in preset (nzxplorer, conservative, progressive, permissive, iss_nz, nz_super, russell_nz, vanguard_aunz). Enterprise or Institutional tier required.
tags:
- Stewardship
x-tier: free
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: Policy name
description:
type: string
description: Policy description
base_preset:
type: string
description: Base preset ID to inherit defaults from
policy:
type: string
description: Policy threshold overrides (must include board_independence_min)
is_default:
type: string
enum:
- 'true'
- 'false'
description: Set as default policy for this user
required:
- name
- policy
responses:
'200':
description: Create Voting Policy
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'
/voting-policies/{id}:
get:
operationId: getVotingPolicy
summary: Voting Policy Detail
description: Get a single voting policy by ID. Enterprise or Institutional tier required.
tags:
- Stewardship
x-tier: free
parameters:
- name: id
in: path
required: true
description: Policy ID
schema:
type: string
responses:
'200':
description: Voting Policy 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'
patch:
operationId: patchVotingPolicies
summary: Update Voting Policy
description: Update an existing voting policy. Only provided fields are changed. Enterprise or Institutional tier required.
tags:
- Stewardship
x-tier: free
parameters:
- name: id
in: path
required: true
description: Policy ID
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: Updated policy name
description:
type: string
description: Updated description
policy:
type: string
description: Updated policy thresholds
is_default:
type: string
enum:
- 'true'
- 'false'
description: Set as default policy
responses:
'200':
description: Update Voting Policy
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'
delete:
operationId: deleteVotingPolicies
summary: Delete Voting Policy
description: Delete a voting policy. Cannot delete a policy that is referenced by stewardship reports. Enterprise or Institutional tier required.
tags:
- Stewardship
x-tier: free
parameters:
- name: id
in: path
required: true
description: Policy ID
schema:
type: string
responses:
'200':
description: Delete Voting Policy
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'
/fund-votes/{ticker}:
get:
operationId: getFundVote
summary: Fund Manager Votes
description: Actual voting records from NZ fund managers (Harbour, Devon, Mint, Fisher, NZ Super Fund) for a specific company. Shows how institutional investors voted on AGM resolutions — FOR, AGAINST, or ABSTAIN — with ISS and management recommendations for comparison.
tags:
- Stewardship
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., AIR, FPH, SPK)
schema:
type: string
- name: fund_manager
in: query
required: false
description: Filter by fund manager name (e.g., Harbour, Devon, Mint)
schema:
type: string
- name: year
in: query
required: false
description: Filter by year (e.g., 2024) or range (e.g., 2023-2025)
schema:
type: string
- name: vote
in: query
required: false
description: 'Filter by vote cast: FOR, AGAINST, or ABSTAIN'
schema:
type: string
responses:
'200':
description: Fund Manager Votes
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