> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: listMembersByBadge(_id: string, options: ListMembersByBadgeOptions)

# Method package: wixMembersV2

# Method menu location: wixMembersV2 --> badges --> listMembersByBadge

# Method Link: https://dev.wix.com/docs/velo/apis/wix-members-v2/badges/list-members-by-badge.md

# Method Description:

Lists the IDs of all members assigned to a badge.


The `listMembersByBadge()` function returns a Promise that resolves to a list of member IDs assigned to the specified badge.

Retrieves up to 1000 site members who have a specified badge. Default `paging.limit` is 100, `paging.offset` - 0.

The `_id` parameter must be an ID from your site's `Members/Badges` collection. Typically, you retrieve the ID from the collection using a query or through a dataset.

This function is not a universal function and runs only on the backend.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## List member IDs with assigned badges.

```javascript
import { badges } from 'wix-members.v2';
import { elevate } from 'wix-auth';

/* Sample _id value: 'ff8e00e5-babd-4fa5-810f-07e932a14d6e'
 *
 * Sample options value:
 * {
 *   paging: {
 *     limit: 3,
 *     offset: 0
 *   }
 * }
 */

export async function myListMembersByBadgeFunction(_id, options) {
  try {
    const elevatedListMembersByBadge = elevate(badges.listMembersByBadge);
    const membersByBadge = await elevatedListMembersByBadge(_id, options);
    
    console.log('Members by Badge: ', membersByBadge);
    return membersByBadge;
  } catch (error) {
    console.error(error);
    // Handle the error
  }

}

/* Promise resolves to:
 * {
 *  "memberIds": [
 *    "7d368843-6f0c-4037-8d0e-b7e36a8a0c32"
 *  ],
 *  "metadata": {
 *    "count": 1,
 *    "offset": 0,
 *    "total": 1
 *  }
 * }
 */ 
```

## List member IDs with assigned badges. (export from backend code)

```javascript
import { Permissions, webMethod } from 'wix-web-module';
import { badges } from 'wix-members.v2';
import { elevate } from 'wix-auth';

/* Sample _id value: 'ff8e00e5-babd-4fa5-810f-07e932a14d6e'
 *
 * Sample options value:
 * {
 *   paging: {
 *     limit: 3,
 *     offset: 0
 *   }
 * }
 */

export const myListMembersByBadgeFunction = webMethod(Permissions.Anyone, async (_id, options) => {
  try {
    const elevatedListMembersByBadge = elevate(badges.listMembersByBadge);
    const membersByBadge = await elevatedListMembersByBadge(_id, options);
    
    console.log('Members by Badge: ', membersByBadge);
    return membersByBadge;
  } catch (error) {
    console.error(error);
    // Handle the error
  }

});

/* Promise resolves to:
 * {
 *  "memberIds": [
 *    "7d368843-6f0c-4037-8d0e-b7e36a8a0c32"
 *  ],
 *  "metadata": {
 *    "count": 1,
 *    "offset": 0,
 *    "total": 1
 *  }
 * }
 */ 

```

---