logoPandorLabs
Sign inGet my data
Finance

New Zealand Insider Filings

New Zealand insider trading data: every director, officer and substantial holder disclosure by NZX-listed companies, with issuer, ticker, reporting person, release time and a link to the full notice.

insider-filings-nzfinanceinsider tradingnzxsubstantial holdernew zealand

15,388 rows in the dataset · last run Nov 9, 2026

Prefer a file without code? Buy the New Zealand Insider Filings dataset or get a free 100-row sample.

Download the dataset

Get the full dataset as one CSV or JSONL file. If the data is older than maxAgeHours, it is refreshed automatically first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/insider-filings-nz/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 15,388 rows, this download costs $9.24, down to $2.31 in volume (154 credits) when the data is fresh enough, or $18.48, down to $4.62 in volume (308 credits) when it has to be refreshed first.

This is a Standard dataset: 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To get exactly the targets you want, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/insider-filings-nz/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "since": "2020-01-01",      "lookbackDays": 7,      "until": "2024-12-31",      "maxFilings": 0    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected ($1.2, down to $0.3 in volume per 1,000 rows). A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Window

  • since

    string

    Filed on or after (YYYY-MM-DD)

    Collects filings back to this date. Empty means the last 7 day(s); set an early date for a full history.

    Default
    none
    Example
    2020-01-01
  • lookbackDays

    number

    Lookback when no start date (days)

    Default
    7
    Range
    1 to 36500
  • until

    string

    Filed on or before (YYYY-MM-DD)

    Default
    none
    Example
    2024-12-31

Limits

  • maxFilings

    number

    Max filings

    0 means no limit. A filing can hold several transaction rows.

    Default
    0
    Range
    at least 0
  • refetchKnown

    boolean

    Re-fetch filings already stored

    Off skips filings already in the dataset, so scheduled runs only add what is new.

    Default
    false

Pacing

  • requestDelayMs

    number

    Delay between requests (ms)

    Default
    250
    Range
    0 to 60000
  • concurrency

    number

    Parallel filing fetches

    Default
    3
    Range
    1 to 16

Targeting

  • symbols

    string[]

    Issuer symbols (full history)

    Collects the full filing history of each issuer within the date window, instead of the market-wide filings.

    Default
    none
    Example
    AAPL, MSFT
Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema
{  "type": "object",  "additionalProperties": false,  "properties": {    "since": {      "type": "string",      "maxLength": 2000,      "title": "Filed on or after (YYYY-MM-DD)",      "description": "Collects filings back to this date. Empty means the last 7 day(s); set an early date for a full history.",      "examples": [        "2020-01-01"      ]    },    "lookbackDays": {      "type": "number",      "minimum": 1,      "maximum": 36500,      "title": "Lookback when no start date (days)",      "default": 7    },    "until": {      "type": "string",      "maxLength": 2000,      "title": "Filed on or before (YYYY-MM-DD)",      "examples": [        "2024-12-31"      ]    },    "maxFilings": {      "type": "number",      "minimum": 0,      "title": "Max filings",      "description": "0 means no limit. A filing can hold several transaction rows.",      "default": 0    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "default": 250    },    "concurrency": {      "type": "number",      "minimum": 1,      "maximum": 16,      "title": "Parallel filing fetches",      "default": 3    },    "refetchKnown": {      "type": "boolean",      "title": "Re-fetch filings already stored",      "description": "Off skips filings already in the dataset, so scheduled runs only add what is new.",      "default": false    },    "symbols": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Issuer symbols (full history)",      "description": "Collects the full filing history of each issuer within the date window, instead of the market-wide filings.",      "examples": [        "AAPL, MSFT"      ]    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/insider-filings-nz/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "since": "2020-01-01",      "lookbackDays": 7,      "until": "2024-12-31",      "maxFilings": 0    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

The fields this scraper delivers. Coverage is the share of rows that include each field.

FieldTypeCoverage
accessionstring100%
acquired_disposedstring100%
countrystring100%
currencystring100%
dedup_keystring100%
details_availableboolean100%
exchangestring100%
insider_namestring100%
insider_titlestring100%
is_directorboolean100%
is_officerboolean100%
is_ten_percent_ownerboolean100%
issuer_namestring93%
rawobject100%
relationshipstring100%
symbolstring100%
trade_typestring100%
transaction_codestring100%
transaction_naturestring100%
venuestring100%
created_atdate100%
filed_atdate100%
first_seen_atdate100%
last_seen_atdate100%
updated_atdate100%
_idstring100%