> 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: queryMemberships()

# Method package: wixGroupsBackend

# Method menu location: wixGroupsBackend --> Members --> queryMemberships

# Method Link: https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/query-memberships.md

# Method Description:

Retrieves a list of up to 100 memberships, given the provided paging, sorting and filtering.

Creates a query to retrieve a list of memberships.  

> **Note:** Only site admins can query a site member's memberships. Site members can query their memberships. However, if the `suppressAuth` option is set to `true`, all permissions are overwritten, and all site members (including non-group members) can query a site member's memberships. 

The `queryMemberships()` function builds a query to retrieve a list of all memberships, and returns a [MembershipsQueryBuilder](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-builder/introduction.md) object.

The returned object contains the query definition which is typically used to run the query using the [`find()`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-builder/find.md) function. 

You can refine the query by chaining `GroupMembersQueryBuilder` functions onto the query. `GroupMembersQueryBuilder` functions enable you to sort, filter, and control the results that `queryMemberships()` returns.

The results of the `queryMemberships()` function are sorted by `groupId` in descending order.   

`queryMemberships()` runs with this `GroupMembersQueryBuilder` default, which you can override:
+ [`limit(100)`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-builder/limit.md)

The following `GroupMembersQueryBuilder` functions are supported for `queryMemberships()`. For a full description of the Memberships object, see the object returned for the [`items`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-result/items.md) property in [`MembershipsQueryResult`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-result/introduction.md).

| Property                    | Supported Filters & Sorting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `status`                    | [`eq()`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-builder/eq.md), [`ne()`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-builder/ne.md)             | 
| `role`                      | [`eq()`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-builder/eq.md), [`ne()`](https://dev.wix.com/docs/velo/apis/wix-groups-backend/members/memberships-query-builder/ne.md)             |



# Method Code Examples:

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

## Query a site member's memberships

```javascript
import { Permissions, webMethod } from 'wix-web-module';
import { members } from 'wix-groups-backend';

export const myQueryMembershipsFunction = webMethod(Permissions.Anyone, () => {
  return members.queryMemberships()
    .find()
    .then((results) => {
      const items = results.items;
      const firstItem = items[0];
      const pageSize = results.pageSize;
      const totalPages = results.totalPages;
      const totalCount = results.totalCount;
      const currentPage = results.currentPage();
      const next = results.next();
      const previous = results.prev();
      const hasNext = results.hasNext();
      const hasPrev = results.hasPrev();
      const length = results.length;

      return items;
    })
    .catch((error) => {
      console.error(error);
    });
});

/* Returns items:
 * [
 *  { 
 *    "groupId": "937cd3db-e9be-4980-93c1-a6d767a11050"
 *    "status": "JOINED"
 *    "role": "ADMIN"
 *  },
 *  {
 *    "groupId": "7fe8e9e1-d050-4c86-9684-e7f231600a34"
 *    "status": "PENDING"
 *    "role": "MEMBER"
 *  }
 * ]
 */
```

---