# tax.filings.get

Read a return or slips the company files itself, step by step: { kind: gst_hst (a GST/HST period), t4a (contractor T4A and T4A-NR slips for a calendarYear) or t2 (a corporate year), period? or calendarYear? (defaults to the newest one that ended) }. Returns the due dates (with weekend and holiday shifts), each walkthrough step and whether it's done, what was recorded (filed on, CRA confirmation number, paid on and amount, copies given), the matching compliance checklist items, the business number on file, the other periods to choose from and the official sources. The numbers to enter come from tax.prep.overview (GST/HST lines) and contractorOps.taxForms.get (slips). Oatmilk never files or pays anything.

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

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

MCP tool: `accounting_tax_filings_get`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `kind` | enum | Yes | Which kind of record or job this is. One of: `gst_hst`, `t4a`, `t2`. |
| `period` | object |  | The period to cover. No other fields. |
| `period.from` | string | Yes | The first date to include, as YYYY-MM-DD. |
| `period.to` | string | Yes | The last date to include, as YYYY-MM-DD. |
| `period.kind` | enum | Yes | Which kind of record or job this is. One of: `corporate`, `gst_hst`. |
| `calendarYear` | integer |  | A calendar year, such as 2026. 2000 to 2100. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/tax.filings.get \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'kind=gst_hst'
```

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