---
title: "Generate Stewardship Report"
method: POST
path: "/stewardship-reports"
tags: ["Stewardship"]
---

# Generate Stewardship Report

`POST /stewardship-reports`

## Request

- Base URL: `https://nzxplorer.co.nz/api/v1`
- URL: `https://nzxplorer.co.nz/api/v1/stewardship-reports`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

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.

## Request body

- object
  - `tickers` string, required: Array of NZX ticker symbols (max 100)
  - `policy_id` string: Voting policy preset ID (default: nzxplorer)

## Response `200`

Generate Stewardship Report

- Envelope: Standard API response envelope
  - `data` unknown
  - `meta` object
    - `api_version` string
    - `timestamp` string, date-time
    - `format` 'standard' | 'llm' | 'fdc3' | 'toon'
    - `endpoint` string

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/nzxplorer/apis/nzxplorer-api.md) · [All operations](https://skmtc.dev/nzxplorer/apis/nzxplorer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nzxplorer/apis/nzxplorer-api/revisions/f3b95341783a?raw)