NZXplorer Corporate Actions API

Takeovers, capital raises, credit ratings, deal advisers

GitHub OpenAPI

Operations 8

GET /deal-advisers/{ticker} Deal Advisers #
GET /deal-prediction/{ticker} Deal Flow Prediction #
GET /adviser-market-share Adviser Market Share #
GET /deal-conflicts/{ticker} Deal Conflicts #
GET /credit-ratings/{ticker} Credit Ratings #
GET /capital-raises/{ticker} Capital Raises #
GET /takeovers/{ticker} Takeovers & M&A #
GET /audit-changes Auditor Changes #

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-corporate-actions-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-corporate-actions-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: NZXplorer Corporate Actions 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: Corporate Actions
  description: Takeovers, capital raises, credit ratings, deal advisers
paths:
  /deal-advisers/{ticker}:
    get:
      operationId: getDealAdviser
      summary: Deal Advisers
      description: Professional advisers (law firms, investment banks, valuers) who advised on capital raises and takeovers for an NZX company. Shows adviser roles, deal values, and firm details. Part of Capital Markets Graph (#671).
      tags:
      - Corporate Actions
      x-tier: free
      parameters:
      - name: ticker
        in: path
        required: true
        description: NZX ticker symbol
        schema:
          type: string
      - name: deal_type
        in: query
        required: false
        description: 'Filter: capital_raise or takeover'
        schema:
          type: string
      - name: role
        in: query
        required: false
        description: 'Filter by adviser role: legal_issuer, underwriter, lead_manager, etc.'
        schema:
          type: string
      responses:
        '200':
          description: Deal Advisers
          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'
  /deal-prediction/{ticker}:
    get:
      operationId: getDealPrediction
      summary: Deal Flow Prediction
      description: '8-factor capital raise probability scoring (0-100) for NZX issuers. Factors: raise frequency, time since last raise, cash burn rate, debt maturity, insider buying, adviser appointment patterns, capital structure stress, sector raise clustering. Use ticker'
      tags:
      - Corporate Actions
      x-tier: free
      parameters:
      - name: ticker
        in: path
        required: true
        description: NZX ticker symbol or "all" for market-wide
        schema:
          type: string
      responses:
        '200':
          description: Deal Flow Prediction
          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'
  /adviser-market-share:
    get:
      operationId: listAdviserMarketShare
      summary: Adviser Market Share
      description: Annual and quarterly league tables showing adviser market share by deal count and value. Includes historical trends, sector specialization, and new entrant tracking.
      tags:
      - Corporate Actions
      x-tier: free
      responses:
        '200':
          description: Adviser Market Share
          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'
  /deal-conflicts/{ticker}:
    get:
      operationId: getDealConflict
      summary: Deal Conflicts
      description: 'Cross-platform conflict detection for deal advisers. Detects 4 conflict types: auditor independence (adviser firm also audits the company), director cross-board (director sits on both issuer and adviser firm boards), MP interest overlap, and councillor interest overlap. Use ticker'
      tags:
      - Corporate Actions
      x-tier: free
      parameters:
      - name: ticker
        in: path
        required: true
        description: NZX ticker symbol or "all" for market-wide
        schema:
          type: string
      responses:
        '200':
          description: Deal Conflicts
          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'
  /credit-ratings/{ticker}:
    get:
      operationId: getCreditRating
      summary: Credit Ratings
      description: Credit rating history from S&P, Moody\
      tags:
      - Corporate Actions
      x-tier: free
      parameters:
      - name: ticker
        in: path
        required: true
        description: NZX ticker symbol (e.g., ANZ, MEL, SPK)
        schema:
          type: string
      - name: action
        in: query
        required: false
        description: 'Filter by action: affirmed, upgraded, downgraded, assigned, withdrawn'
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: 'Results per page (default: 50)'
        schema:
          type: integer
      - name: offset
        in: query
        required: false
        description: 'Pagination offset (default: 0)'
        schema:
          type: integer
      responses:
        '200':
          description: Credit Ratings
          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'
  /capital-raises/{ticker}:
    get:
      operationId: getCapitalRaises
      summary: Capital Raises
      description: 'Structured capital raise history: placements, rights issues, SPPs, IPOs, bonds, buybacks, DRPs. ~11,700 events across 131 issuers.'
      tags:
      - Corporate Actions
      x-tier: free
      parameters:
      - name: ticker
        in: path
        required: true
        description: NZX ticker symbol (e.g., AIR, FBU, RYM)
        schema:
          type: string
      - name: type
        in: query
        required: false
        description: 'Comma-separated raise types: placement, rights_issue, spp, ipo, bond, buyback, drp, options_exercise, employee_scheme, conversion'
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: 'Results per page (default: 50)'
        schema:
          type: integer
      - name: offset
        in: query
        required: false
        description: 'Pagination offset (default: 0)'
        schema:
          type: integer
      responses:
        '200':
          description: Capital Raises
          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'
  /takeovers/{ticker}:
    get:
      operationId: getTakeover
      summary: Takeovers & M&A
      description: 'Structured M&A and takeover activity: takeover offers, mergers, schemes of arrangement, compulsory acquisitions, asset acquisitions. 313 deals across 51 issuers (2017-2026). Deal details include acquirer, offer price, total value, premium, acceptance %, status, and timeline.'
      tags:
      - Corporate Actions
      x-tier: free
      parameters:
      - name: ticker
        in: path
        required: true
        description: 'Path parameter: ticker'
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: 'Comma-separated: announced, conditional, unconditional, completed, withdrawn, failed'
        schema:
          type: string
      - name: deal_type
        in: query
        required: false
        description: 'Comma-separated: takeover_offer, merger, scheme_of_arrangement, compulsory_acquisition, acquisition'
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: Max results (default 50)
        schema:
          type: number
      - name: offset
        in: query
        required: false
        description: Pagination offset (default 0)
        schema:
          type: number
      responses:
        '200':
          description: Takeovers & M&A
          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'
  /audit-changes:
    get:
      operationId: listAuditChanges
      summary: Auditor Changes
      description: Auditor appointment, resignation, and change history for NZX companies. Tracks Big Four (PwC, KPMG, Deloitte, EY) movements.
      tags:
      - Corporate Actions
      x-tier: free
      parameters:
      - name: ticker
        in: query
        required: false
        description: Filter by NZX ticker symbol
        schema:
          type: string
      - name: action
        in: query
        required: false
        description: 'Filter: appointed, resigned, changed, reappointed'
        schema:
          type: string
      - name: auditor
        in: query
        required: false
        description: Filter by auditor name (partial match)
        schema:
          type: string
      responses:
        '200':
          description: Auditor Changes
          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'
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