# contractors.hours.list

List time entries logged by contractors (date, minutes, description, status draft, submitted, approved or rejected, review reason), filtered by contractorId, status and from and to dates. For timesheets by pay period use contractorOps.timesheets.list.

`GET | POST /api/v1/accounting/contractors.hours.list`

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

MCP tool: `accounting_contractors_hours_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `limit` | integer |  | How many results to return at most. 1 to 100. Default `30`. |
| `offset` | integer |  | How many results to skip, for the next page of a list. 0 to 9007199254740991. Default `0`. |
| `contractorId` | string (ID) |  | The ID of a contractor, from contractors.list. |
| `status` | enum |  | Only include records with this status. One of: `draft`, `submitted`, `approved`, `rejected`. |
| `from` | string (date) |  | The first date to include, as YYYY-MM-DD. |
| `to` | string (date) |  | The last date to include, as YYYY-MM-DD. |

## Example request

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

Reference page: https://app.getoatmilk.com/docs/api/contractors.hours.list