> 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: listJoinRequests(groupId: string, paging: Paging, options: Options)

# Method package: wixGroupsBackend

# Method menu location: wixGroupsBackend --> JoinRequests --> listJoinRequests

# Method Link: https://dev.wix.com/docs/velo/apis/wix-groups-backend/join-requests/list-join-requests.md

# Method Description:

Lists requests to join a group.

 

> **Note: This function is only relevant for private groups.** 

The `listJoinRequests()` function returns a Promise that resolves to a list of up to 100 requests to join a group. Sorts by default to `_createdDate` in descending order.
Only site admins and group admins can see requests to join their group. Site members can access their own join requests in their site.

> **Notes:** 
> + If the `suppressAuth` option is set to `true`, all permissions are overwritten, and all site members (including non-group members) can see requests to join a group. 
> + This function's parameters are positional, and must be specified in the sequence shown in the syntax below. When specifying a parameter, use `null` as a placeholder for any unspecified parameters. For example, to specify `limit` only, call `listJoinRequests(groupId, paging, null)`. To specify `supressAuth` only, call `listJoinRequests(groupId, null, options)`.



# Method Code Examples:

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

## List all requests to join a group

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

// Sample groupId value:
// 'fc3df3c1-36b2-4279-8be1-8e72a05a88c8'

export const myListJoinRequestsFunction = webMethod(Permissions.Anyone, (groupId) => {
  return joinRequests.listJoinRequests(groupId)
    .then((joinRequestsResults) => {
      const joinRequestStatus = joinRequestsResults.joinRequests[0].status;
      return joinRequestsResults;
    })
    .catch((error) => {
      console.error(error);
    });
});

/* Promise resolves to:
 * joinRequests: [
 *  { 
 *    "memberId": "937cd3db-e9be-4980-93c1-a6d767a11050"
 *    "_createdDate": "Wed May 14 2021 10:05:20 GMT+0300"
 *    "status": "REJECTED"
 *    "rejectionReason": "Wrong group."
 *  },
 *  {
 *    "memberId": "7fe8e9e1-d050-4c86-9684-e7f231600a34"
 *    "_createdDate": "Sun July 11 2020 03:25:30 GMT+0300"
 *    "status": "PENDING"
 *  }
 * ],
 * metadata: 
 *  {
 *   "length": 2
 *   "tooManyToCount": false
 *   "totalCount": 5
 *  }
 */
```

## List all requests to join a group using options

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

// Sample groupId value:
// 'fc3df3c1-36b2-4279-8be1-8e72a05a88c8'
//
// Sample paging value:
// {
//   limit: 2,
//   skip: 1
// }
//
// Sample options value:
// {
//   suppressAuth: true
// }

export const myListJoinRequestsFunction = webMethod(Permissions.Anyone, async (groupId, paging, options) => {
  try {
    const joinRequestsResults = await joinRequests.listJoinRequests(groupId, paging, options);
    const joinRequestStatus = joinRequestsResults.joinRequests[0].status;
    return joinRequestsResults;
  } catch (error) {
    console.error(error);
  }
});

/* Promise resolves to:
 * joinRequests: [
 *  { 
 *    "memberId": "937cd3db-e9be-4980-93c1-a6d767a11050"
 *    "_createdDate": "Wed May 14 2021 10:05:20 GMT+0300"
 *    "status": "REJECTED"
 *    "rejectionReason": "Wrong group."
 *  },
 *  {
 *    "memberId": "7fe8e9e1-d050-4c86-9684-e7f231600a34"
 *    "_createdDate": "Sun July 11 2020 03:25:30 GMT+0300"
 *    "status": "PENDING"
 *  }
 * ],
 * metadata: 
 *  {
 *   "length": 2
 *   "tooManyToCount": false
 *   "totalCount": 5
 *  }
 */
```

---