# GetItems(SearchContext, SearchFlags)

> Initiates a search and returns all search items matching the search context. Other items can be found later using asynchronous searches.

## Definition

* **Type:** Method
* **Namespace:** [UnityEditor.Search](/engine/6000.3/script-reference/unityeditor/search.md)
* **Assembly:** UnityEditor

```csharp
public static List<SearchItem> GetItems(SearchContext context, SearchFlags options = SearchFlags.Default)
```

### Parameters

**** (\[SearchContext]\(/engine/6000.3/script-reference/unityeditor/search/searchcontext)): The current search context.**** (\[SearchFlags]\(/engine/6000.3/script-reference/unityeditor/search/searchflags)): Options defining how the query is performed.

### Returns

| Type                                                                                          | Description                                       |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| [List\<SearchItem>](https://learn.microsoft.com/dotnet/api/system.collections.generic.list-1) | A list of search items matching the search query. |

### Remarks

Unity suggests using [SearchService.Request](/engine/6000.3/script-reference/unityeditor/search/searchservice/request.md) to execute a search query. `GetItems` usually requires setting up more context to achieve a good result. The following is a small example that uses `GetItems`.

### Examples

```csharp
using System.Collections.Generic;
using UnityEditor;
using UnityEditor.Search;
using UnityEngine;

static class Example_SearchService_GetItems
{
    [MenuItem("Examples/SearchService/GetItems")]
    public static void Run()
    {
        // Create a container to hold found items.
        var results = new List<SearchItem>();

        // Create the search context that will be used to execute the query.
        using (var searchContext = SearchService.CreateContext("scene", "is:leaf"))
        {
            // Initiate the query and get the results.
            // Note: it is recommended to use SearchService.Request if you wish to fetch the items asynchronously.
            results = SearchService.GetItems(searchContext, SearchFlags.WantsMore | SearchFlags.Synchronous);

            // Print results
            foreach (var searchItem in results)
                Debug.Log(searchItem.GetDescription(searchContext));
        }
    }
}
```
