> 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: queryJoinGroupRequests(groupId: string, options: QueryJoinGroupRequestsOptions)

# Method package: wixGroupsV2

# Method menu location: wixGroupsV2 --> joinGroupRequests --> queryJoinGroupRequests

# Method Link: https://dev.wix.com/docs/velo/apis/wix-groups-v2/join-group-requests/query-join-group-requests.md

# Method Description:

Creates a query to retrieve a list of join requests.  

> **Notes:** 
> + This function is only relevant for private groups.
> + For `SECRET` groups, only site admins and group admins can query requests to join their group. <!-- However, if the `suppressAuth` option is set to `true`, all permissions are overwritten, and all site members (including non-group members) can query requests to join a group. -->

The `queryjoinGroupRequests()` function builds a query to retrieve a list of all requests to join a group, and returns a `JoinGroupRequestsQueryBuilder` object.

The returned object contains the query definition which is typically used to run the query using the [`find()`](/join-group-requests-query-builder/find) function. 

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

The results of the `queryjoinGroupRequests()` function are sorted by `_createdDate` in descending order.   

`queryjoinGroupRequests()` runs with this `joinGroupRequestsQueryBuilder` default, which you can override:
+ [`limit(100)`](/join-group-requests-query-builder/limit)

The following `joinGroupRequestsQueryBuilder` functions are supported for `queryjoinGroupRequests()`. For a full description of the joinGroupRequests object, see the object returned for the [`items`](/join-group-requests-query-result/items) property in `JoinGroupRequestsQueryResult`.                         



|PROPERTY	|SUPPORTED FILTERS & SORTING	
|:---:|:---:|
|`status`|[`eq()`](/join-group-requests-query-builder/eq),[`ne()`](/join-group-requests-query-builder/ne),[`exists()`](/join-group-requests-query-builder/exists),[`in()`](/join-group-requests-query-builder/in),[`hasSome()`](/join-group-requests-query-builder/has-some)|



# Method Code Examples:

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

## Query requests to join a group (dashboard page code)

```javascript
import { joinGroupRequests } from 'wix-groups-v2';

export function myQueryJoinGroupRequestsFunction() {
  return joinRequests.queryJoinGroupRequests()
    .find()
    .then((queryResults) => {
      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:
 * [
 *  {
 *    "memberId": "7fe8e9e1-d050-4c86-9684-e7f231600a34"
 *    "_createdDate": "Fri Oct 24 2021 22:45:50 GMT+0300"
 *    "status": "PENDING"
 *  },
 *  {
 *    "memberId": "937cd3db-e9be-4980-93c1-a6d767a11050"
 *    "_createdDate": "Wed May 14 2021 10:05:20 GMT+0300"
 *    "status": "REJECTED"
 *    "rejectionReason": "Wrong group"
 *  },
 *  {
 *    "memberId": "2CD58761-d050-4c86-9684-e7f2316229b3"
 *    "_createdDate": "Sun July 11 2020 03:25:30 GMT+0300"
 *    "status": "APPROVED"
 *  }
 * ]
 */
```

## Query requests to join a group (export from backend code)

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

export const myQueryJoinGroupRequestsFunction = webMethod(Permissions.Anyone, () => {
  return joinGroupRequests.queryJoinGroupRequests()
    .find()
    .then((queryResults) => {
      const items = queryResults.items;
      const firstItem = items[0];
      const pageSize = queryResults.pageSize;
      const totalPages = queryResults.totalPages;
      const totalCount = queryResults.totalCount;
      const currentPage = queryResults.currentPage;
      const next = queryResults.next();
      const previous = queryResults.prev();
      const hasNext = queryResults.hasNext();
      const hasPrev = queryResults.hasPrev();
      const length = queryResults.length;

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

/* Returns items:
 * [
 *  {
 *    "memberId": "7fe8e9e1-d050-4c86-9684-e7f231600a34"
 *    "_createdDate": "Fri Oct 24 2021 22:45:50 GMT+0300"
 *    "status": "PENDING"
 *  },
 *  {
 *    "memberId": "937cd3db-e9be-4980-93c1-a6d767a11050"
 *    "_createdDate": "Wed May 14 2021 10:05:20 GMT+0300"
 *    "status": "REJECTED"
 *    "rejectionReason": "Wrong group"
 *  },
 *  {
 *    "memberId": "2CD58761-d050-4c86-9684-e7f2316229b3"
 *    "_createdDate": "Sun July 11 2020 03:25:30 GMT+0300"
 *    "status": "APPROVED"
 *  }
 * ]
 */

```

---