# tax.estimates.get

Read Canadian corporate income-tax and GST/HST planning reserves as of an optional YYYY-MM-DD date. Includes the current and previous eligible fiscal years, plus the current GST/HST period and up to one preceding year of filing periods. Uses the saved planning rate (30% by default), supported credits, period-attributed payments and ranges for unsettled records and unmatched bank amounts. Each period's reserve is floored separately; older unpaid balances remain outside the estimate. Unknown currency, registration or entity details remain explicit. This does not calculate a final return, file or pay tax; reading it never sends email.

`GET | POST /api/v1/accounting/tax.estimates.get`

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

MCP tool: `accounting_tax_estimates_get`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `asOf` | string |  |  |

## Example request

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

Reference page: https://app.getoatmilk.com/docs/api/tax.estimates.get