`contractorOps.history.rateBackfill.preview`

Preview imported timesheets missing a source amount and rate, with the active hourly agreement covering each complete period. Shows which weeks are ready to save and which need review because an agreement changes, is missing, or has a currency or rate conflict. No data changes and no payout is prepared.

GETPOST/api/v1/accounting/contractorOps.history.rateBackfill.preview

Permissions

accounting:read

Who can call it

admin

Retries

Safe to retry: it only reads

MCP

accounting_contractor_ops_history_rate_backfill_preview

Fields

contractorIdstring (ID)
The ID of a contractor, from contractors.list.
fromstring (date)
The first date to include, as YYYY-MM-DD.
tostring (date)
The last date to include, as YYYY-MM-DD.
limitinteger
How many results to return at most.
1 to 500 · Default 100
offsetinteger
How many results to skip, for the next page of a list.
0 to 100000 · Default 0

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

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/contractorOps.history.rateBackfill.preview", {
  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/contractorOps.history.rateBackfill.preview",
    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/contractorOps.history.rateBackfill.preview

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

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/contractorOps.history.rateBackfill.preview", {
  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/contractorOps.history.rateBackfill.preview",
    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