---
title: "entities(matching:)"
framework: appintents
role: symbol
role_heading: Instance Method
path: "appintents/entitystringquery/entities(matching:)"
---

# entities(matching:)

Retrieves instances by string.

## Declaration

```swift
func entities(matching string: String) async throws -> Self.Result
```

## Parameters

- `string`: “Name” used to refer to an entity instance (or a set thereof).