# company.shareholders.export

Download the shareholder register as a spreadsheet with full tax numbers, to file Schedule 50 or T5 slips, with a reason. Only an administrator in the dashboard can; the download is audited with the reason and the number of shareholders, never the numbers. Not available to API keys or MCP clients.

`POST /api/v1/accounting/company.shareholders.export`

Permissions: `accounting:read`, `accounting:write`, `accounting:admin` · Roles: admin

Not available over MCP: The shareholder register with full SINs and business numbers.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `reason` | string | Yes | A short note saying why, kept in the record's history. 5–500 characters. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/company.shareholders.export \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "Synthetic example from the docs"
}'
```

Reference page: https://app.getoatmilk.com/docs/api/company.shareholders.export