# contractorOps.history.allocations.get

What one contractor's payments and imported timesheets look like for sharing a payment across timesheets (contractorId; transactionId or payoutId to include that payment even when it isn't linked to them yet). payments lists each outgoing bank payment linked to them and each payment recorded in Oatmilk with no pay period, newest first, with its date, amount, kind (wise, bank or recorded), what it already gave which timesheets (allocations), and the timesheets an earlier Mark paid tied to it without amounts (legacyHistoryIds). timesheets lists their imported timesheets with the period, hours, amount (null for a fixed fee with no amount), what payments gave each, and whether it's unpaid, partly paid or paid and how. Nothing changes.

`GET | POST /api/v1/accounting/contractorOps.history.allocations.get`

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

MCP tool: `accounting_contractor_ops_history_allocations_get`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `contractorId` | string (ID) | Yes | The ID of a contractor, from contractors.list. |
| `transactionId` | string (ID) |  | The ID of a bank or card transaction, from transactions.list. |
| `payoutId` | string (ID) |  | The ID of the related record. |

## Example request

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

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