# Get Members With Roles

**Introduction**&#x20;

This step searches for and lists all members in a guild who have specific roles.

**Description**&#x20;

Identifies and returns a list of guild members who possess all of the specified roles. The public role is not considered in this search.

**Configuration**

1. **Guild**: Choose the guild in which to search for members. This is a required field.
2. **Roles**: Select the roles to be used as search criteria. At least one role must be specified, with a maximum of 10 roles allowed.

**Outputs**

* **Members**: A list of members from the guild who match the specified role criteria. Each member in the list is represented according to the `MemberType`.

**Usage**&#x20;

Ideal for filtering members based on their roles, especially useful in guilds with defined hierarchies or specific groupings.

**Permissions**

* No specific permissions are required for this search operation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flexy.bot/modules/discord/steps/get-members-with-roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
