# personalTax.company.shares.list

List explicitly shared personal tax details for an exact organization. Current company administrators can review company consents. External accountants need current company tax_numbers access and either the person's company-accountant consent or an individual personal grant. Returns safe purpose, exact period, masked metadata and a secure private view/copy handoff. Never returns full numbers or reveals whether an unshared person saved a private number.

`GET | POST /api/v1/accounting/personalTax.company.shares.list`

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

MCP tool: `accounting_personal_tax_company_shares_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `organizationId` | string | Yes | The company to work in, for people who belong to more than one. API keys belong to one company. 1–200 characters. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/personalTax.company.shares.list \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'organizationId=example'
```

Reference page: https://app.getoatmilk.com/docs/api/personalTax.company.shares.list