NZXplorer Stewardship API

Stewardship reports, voting policies, and fund manager votes

GitHub OpenAPI

Operations 10

GET /stewardship-reports List Stewardship Reports #
POST /stewardship-reports Generate Stewardship Report #
GET /stewardship-reports/{id} Stewardship Report Detail #
GET /stewardship-reports/{id}/pdf Stewardship Report PDF #
GET /voting-policies List Voting Policies #
POST /voting-policies Create Voting Policy #
GET /voting-policies/{id} Voting Policy Detail #
PATCH /voting-policies/{id} Update Voting Policy #
DELETE /voting-policies/{id} Delete Voting Policy #
GET /fund-votes/{ticker} Fund Manager Votes #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nzxplorer-co-nz:nzxplorer-co-nz-stewardship-api"
All apis
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.

Get an API 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 Specification

nzxplorer-co-nz-stewardship-api-openapi.yml Raw ↑
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