# engagements.list

List agreement versions for an existing project. One engagement can involve multiple independent legal businesses; trading names remain separate. Includes draft, proposed, review and recorded executed states. No signed or paid status is inferred.

`GET | POST /api/v1/accounting/engagements.list`

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

MCP tool: `accounting_engagements_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `projectId` | string (ID) | Yes | The ID of the related record. |
| `limit` | integer |  | How many results to return at most. 1 to 100. Default `25`. |
| `offset` | integer |  | How many results to skip, for the next page of a list. 0 to 9007199254740991. Default `0`. |

## Example request

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

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