`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.

GETPOST/api/v1/accounting/tax.filings.get

Permissions

accounting:read

Who can call it

admin, finance

Retries

Safe to retry: it only reads

MCP

accounting_tax_filings_get

Fields

kindenumRequired
Which kind of record or job this is.
gst_hstt4at2
periodobject
The period to cover.
No other fields
calendarYearinteger
A calendar year, such as 2026.
2000 to 2100

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

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/tax.filings.get?kind=gst_hst", {
  headers: {
    Authorization: `Bearer ${process.env.OATMILK_API_KEY}`,
  },
});
const { data, error } = await response.json();
if (!response.ok) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os

import requests

response = requests.get(
    "https://app.getoatmilk.com/api/v1/accounting/tax.filings.get",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "kind": "gst_hst",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Response

{
  "data": { … }
}

Try it

Checks your input with this action’s real schema and answers like the API, with synthetic data. No key needed, and nothing changes.

Input

GET/api/v1/accounting/tax.filings.get

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

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/tax.filings.get?kind=gst_hst", {
  headers: {
    Authorization: `Bearer ${process.env.OATMILK_API_KEY}`,
  },
});
const { data, error } = await response.json();
if (!response.ok) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os

import requests

response = requests.get(
    "https://app.getoatmilk.com/api/v1/accounting/tax.filings.get",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "kind": "gst_hst",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Fields

Fields inside period

Example

Try it