NZXplorer Corporate Actions API
Takeovers, capital raises, credit ratings, deal advisers
Takeovers, capital raises, credit ratings, deal advisers
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-corporate-actions-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 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