# LookupItemRequest

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.LookupItemRequest/

One list to read in a [GetLookupItems](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/GetLookupItems/index.md) call.

- **Full name:** `MFiles.LookupItemRequest`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-external_data_source_refresh"></a>`external_data_source_refresh` | [`ExtDBRefreshType`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.ExtDBRefreshType/index.md) | 1 | For a list connected to an external database: whether to refresh it from the database before the read. `EXT_DBREFRESH_TYPE_NONE` reads the items the vault already has. Values: `EXT_DBREFRESH_TYPE_NONE` (0), `EXT_DBREFRESH_TYPE_QUICK` (1), `EXT_DBREFRESH_TYPE_FULL` (2). |
| <a id="f-value_list_id"></a>`value_list_id` | `int32` | 2 | The ID of the value list or object type whose items are wanted. |
| <a id="f-property_def"></a>`property_def` | `int32` | 3 | The ID of the lookup property being edited, to apply its value filter (`PropertyDef.value_list_item_filter`), or -1 for no filter. Set -1 explicitly: the default 0 is a real property definition ID (Name or title). |
| <a id="f-search_conditions"></a>`search_conditions` | repeated [`SearchCondition`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.SearchCondition/index.md) | 4 | Item conditions, combined with AND, on the item pseudo properties 1-8 (for example 2 = name); see the [IRPCValueLists](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/index.md) overview. Deleted items are left out unless the condition Deleted (5) equal to true is given. |
| <a id="f-results_limit"></a>`results_limit` | optional `uint32` | 5 | The maximum number of items to return. Unset or 0 returns all. |

<a id="used-by-methods"></a>

## Used by methods

- [IRPCValueLists.GetLookupItems](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/GetLookupItems/index.md): Gets the selectable items of one or more value lists or object types in one call, for example to fill lookup controls.

<a id="used-in-fields"></a>

## Used in fields

- [`GetLookupItemsRequest.requests`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/GetLookupItems/index.md#request): One request per value list or object type. See [LookupItemRequest](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.LookupItemRequest/index.md).