# tax.prizes.schedule

The T4A summary schedule for a calendar year { year } as a CSV: winner, legal name, SIN or business number, address, amount, box 028 and payment dates. Numbers are masked. reveal { reason } shows full numbers to an administrator in the dashboard or to the accountant, and is audited with the reason.

`POST /api/v1/accounting/tax.prizes.schedule`

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

Not available over MCP: Winners' full tax numbers.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `year` | integer | Yes | 2000 to 2200. |
| `reveal` | object |  | No other fields. |
| `reveal.reason` | string | Yes | A short note saying why, kept in the record's history. 10–500 characters. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/tax.prizes.schedule \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026
}'
```

Reference page: https://app.getoatmilk.com/docs/api/tax.prizes.schedule