# contractorOps.roles.list

List the company's job roles (job descriptions for contractors and employees): title, level, department, type, summary, responsibilities, requirements, pay band (currency, lowest and highest amount in minor units, paid per hour, day, week, month or year), and the active contractors who have each role. A job is every role with the same title, and its levels form a ladder in levelOrder (1 is the first rung; null until someone reorders them). Archived roles are left out unless includeArchived is true.

`GET | POST /api/v1/accounting/contractorOps.roles.list`

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

MCP tool: `accounting_contractor_ops_roles_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `includeArchived` | boolean |  | Also include archived records. |

## Example request

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

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