# contractorOps.terms.get

Read a contractor's agreement terms: the version in effect today (role, rate, pay schedule, hour limits per day, week, month or in total, dates, notice, where the work is done, notable clauses), versions starting later, an update waiting for signature or confirmation, the full history with what each version changed, how many of today's, this week's, month's and the agreement's hours are used, the agreement that ended with no decision yet and what happened since (ended), what happened to each filed agreement's terms (reads: reading, read, queued behind an update out for signature, kept as history, or failed, with the reason), and the renewal to suggest (renewal: the same terms for another stretch, from the day after the end, or from the day after it ended when they kept working, with effectiveFrom, the new dates in terms, its length, endsIn days, and due when it ends within 45 days or already has; null with no end date, when later terms are set, or while an update is waiting). Send it with contractorOps.terms.propose, changing anything first.

`GET | POST /api/v1/accounting/contractorOps.terms.get`

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

MCP tool: `accounting_contractor_ops_terms_get`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `contractorId` | string (ID) | Yes | The ID of a contractor, from contractors.list. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/contractorOps.terms.get \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'contractorId=4d5e6f7a-8b9c-4d0e-8f1a-2b3c4d5e6f7a'
```

Reference page: https://app.getoatmilk.com/docs/api/contractorOps.terms.get