> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://support.atomicwork.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://support.atomicwork.com/_mcp/server.

# getFormFieldEntities

Get entity options for a form field.

Returns entity options for a specific form field (e.g., status, priority, assignee). Use this to populate dropdown/select fields that reference entities. **WHEN TO USE THIS ENDPOINT:**
Use this endpoint when a form field has `type: "ENTITY_REFERENCE"`.

## Parameters

| Name                                 | Type                        | Required | Description                                                                       |
| ------------------------------------ | --------------------------- | -------- | --------------------------------------------------------------------------------- |
| `entityType`                         | EntityType                  | Yes      | The entity type for the form field                                                |
| `referenceKey`                       | string                      | Yes      | The reference key of the dropdown field                                           |
| `workspace_id`                       | integer                     | No       | The workspace ID                                                                  |
| `request_type`                       | RequestTypeDTO              | No       | The request type (REQUEST, INCIDENT, SERVICE_REQUEST, PROBLEM)                    |
| `request_id`                         | string                      | No       | The request display ID                                                            |
| `entity_id`                          | integer                     | No       | The entity ID (e.g., service item ID)                                             |
| `parent_option_id`                   | integer                     | No       | Parent option ID for nested dropdowns                                             |
| `search_key`                         | string                      | No       | Search key to filter options                                                      |
| `is_flattened_nested_field_required` | boolean                     | No       | Whether to return flattened nested field options Default: `False`.                |
| `is_workspace_member`                | boolean                     | No       | Filter by workspace membership                                                    |
| `page`                               | integer                     | No       | Default: `1`.                                                                     |
| `per_page`                           | integer                     | No       | Default: `25`.                                                                    |
| `template_id`                        | integer                     | No       | Change template ID. When entity_type=CHANGE and reference_key=requester,          |
| `user_type`                          | UserTypeDto                 | No       | Narrows an `assignee` or `requester` lookup to a single user category. `EMPLOYEE` |
| `availability_status`                | AgentAvailabilityStatusEnum | No       | Applied only to the assignee resolution path; ignored for other entity types and  |