contractorOps.agreements.list
List contractor agreements from the versions of each contractor's terms, for a view: all, active (in effect), ending (in effect with an end date within 45 days), expired (the one in effect has passed its end date) or waiting (an update waiting for a signature or a check), with counts for every view. Each has the contractor, role, rate, start and end dates, days left, state (active, ending, expired, upcoming, replaced or waiting), finance's end decision for an expired one (continuing, ending, or null when undecided), when a renewal starts, whether new terms are waiting (renewalPending), for an undecided expired one whether they kept working and what happened since (the same as contractorOps.agreements.ended), and href, the contractor's Agreement tab. Each version also says where its signed copy is (copy: a document in Oatmilk, or a link when it was signed elsewhere). Without contractorId it covers the organization, lists active contractors with no agreement recorded, and lists signed agreements imported with the dates not stated (undated), which aren't in the views by date. With contractorId it covers that contractor and adds their documents on file from contractor agreements, signing envelopes and imports (items, each an agreement or an nda, with signedElsewhere for a copy kept at its link and datesNotStated for an undated one), whether an agreement is on file (status on_file, signed_elsewhere, terms_on_file, requested, draft or agreement_missing), and whether a signed NDA is.
/api/v1/accounting/contractorOps.agreements.listPermissions
Who can call it
Retries
MCP
accounting_contractor_ops_agreements_listFields
contractorIdstring (ID)The ID of a contractor, from contractors.list.
viewenumallactiveendingexpiredwaitingDefault "all"
Example
curl https://app.getoatmilk.com/api/v1/accounting/contractorOps.agreements.list \
-H "Authorization: Bearer $OATMILK_API_KEY"{
"data": { … }
}Try it
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.
curl https://app.getoatmilk.com/api/v1/accounting/contractorOps.agreements.list \
-H "Authorization: Bearer $OATMILK_API_KEY"More in Contractors.