# personalTax.shareholder.requests.list

Read your own shareholder setup requests across companies with current verified person matching, exact task links and truthful email state. Saving setup remains separate from sharing personal tax details.

`GET | POST /api/v1/accounting/personalTax.shareholder.requests.list`

Permissions: `accounting:read` · Roles: admin, finance, contributor, accountant

MCP tool: `accounting_personal_tax_shareholder_requests_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `requestId` | string (ID) |  | The ID of the related record. |
| `status` | enum |  | Only include records with this status. One of: `open`, `all`. Default `"open"`. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/personalTax.shareholder.requests.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

Reference page: https://app.getoatmilk.com/docs/api/personalTax.shareholder.requests.list