`history.list`

List everything anyone changed in the company, newest first: people in Oatmilk, Ask AI, AI apps over MCP, the API, contractors and signers in their portals, and Oatmilk's own automation (Autopilot, syncs, readers). Each item is one step (all records one person changed at once), with who, how (source), what, the record, and whether it was rolled back. Filter by from/to dates, query (text), actorIds, sources (web, assistant, mcp, api, automation, portal, signer), areas (banking, transactions, budgets, inbox, invoices, reimbursements, agreements, contractors, recruiting, tax, compliance, subscriptions, access, settings), actions (exact action names), statuses (succeeded, failed, rolledBack, active, revertible) and targetId (one record's changes). Sort by at, actor, action, area, size or source, asc or desc. Pages with cursor; total counts every match.

GETPOST/api/v1/accounting/history.list

Permissions

accounting:read

Who can call it

admin, finance

Retries

Safe to retry: it only reads

MCP

accounting_history_list

Fields

fromstring
The first date to include, as YYYY-MM-DD.
at most 40 characters
tostring
The last date to include, as YYYY-MM-DD.
at most 40 characters
querystring
Text to search for.
at most 200 characters
actorIdsarray of strings
A list of record IDs.
at most 50 items · each 1–200 characters
sourcesarray of enum values
webassistantmcpapiautomationportalsigner
at most 7 items
areasarray of enum values
bankingtransactionsbudgetsinboxinvoicesreimbursementsagreementscontractorsrecruitingtaxcompliancesubscriptionsaccesssettings
at most 14 items
actionsarray of strings
at most 100 items · each Matches ^[A-Za-z][A-Za-z0-9_.]{0,119}$
statusesarray of enum values
succeededfailedrolledBackactiverevertible
at most 5 items
targetIdstring
1–200 characters
sortenum
atactoractionareasizesource
Default "at"
directionenum
ascdesc
Default "desc"
cursorstring
Where the next page starts: the nextCursor value from the previous response.
1–2000 characters
limitinteger
How many results to return at most.
1 to 200 · Default 50

curl https://app.getoatmilk.com/api/v1/accounting/history.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/history.list", {
  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/history.list",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    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/history.list

curl https://app.getoatmilk.com/api/v1/accounting/history.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/history.list", {
  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/history.list",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Fields

Example

Try it