# tax.prizes.overview

Prize payouts for a calendar year (default: the latest with payouts): events, winners with masked details and intake link state, confirmed payouts, suggestions detected from outgoing transfers (never applied automatically), the per-winner total against the $500 T4A box 028 threshold with a plain status (under $500, T4A needed, waiting for winner details, ask your accountant), sponsorship invoices shown separately, and the checklist for the CRA RZ account and the filing deadline. Optional eventId includes that active workspace event when opening an older map result, without changing totals or other source counts. No HST applies to prizes. Nothing is sent or filed.

`GET | POST /api/v1/accounting/tax.prizes.overview`

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

MCP tool: `accounting_tax_prizes_overview`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `year` | integer |  | 2000 to 2200. |
| `eventId` | string (ID) |  | The ID of the related record. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/tax.prizes.overview \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

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