> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Users Waiting for Group Key

> Retrieves, for each of the specified encrypted rooms, the members who are waiting for the room's E2E key and have an E2E public key. Members who already have a room key or a suggested key are not returned, and the authenticated user is excluded. Up to 50 users are returned per room, and rooms with no waiting users are left out of the response.

If E2E encryption is disabled in the workspace, `usersWaitingForE2EKeys` is an empty object.

### Changelog
| Version | Description |
| ------- | ------------|
| 6.10.0  | Added       |

## OpenAPI

````json GET /api/v1/e2e.fetchUsersWaitingForGroupKey
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Settings"
  },
  "servers": [
    {
      "url": "https://apiexplorer.support.rocket.chat"
    }
  ],
  "tags": [
    {
      "name": "Settings"
    },
    {
      "name": "Audit"
    },
    {
      "name": "Cloud"
    },
    {
      "name": "DNS"
    },
    {
      "name": "E2E"
    },
    {
      "name": "Import"
    },
    {
      "name": "Bulk User Import"
    },
    {
      "name": "Instances"
    },
    {
      "name": "Moderation"
    },
    {
      "name": "Device Management"
    },
    {
      "name": "Password policy"
    },
    {
      "name": "Video Conference"
    },
    {
      "name": "Media Calls"
    }
  ],
  "paths": {
    "/api/v1/e2e.fetchUsersWaitingForGroupKey": {
      "get": {
        "summary": "Get Users Waiting for Group Key",
        "operationId": "get-api-v1-e2e.fetchUsersWaitingForGroupKey",
        "description": "Retrieves, for each of the specified encrypted rooms, the members who are waiting for the room's E2E key and have an E2E public key. Members who already have a room key or a suggested key are not returned, and the authenticated user is excluded. Up to 50 users are returned per room, and rooms with no waiting users are left out of the response.\n\nIf E2E encryption is disabled in the workspace, `usersWaitingForE2EKeys` is an empty object.\n\n### Changelog\n| Version | Description |\n| ------- | ------------|\n| 6.10.0  | Added       |",
        "tags": [
          "E2E"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-User-Id"
          },
          {
            "$ref": "#/components/parameters/X-Auth-Token"
          },
          {
            "name": "roomIds",
            "in": "query",
            "required": true,
            "description": "The IDs of the rooms to check. To check several rooms, repeat the parameter, for example `roomIds=wCiXndNp5NqNY3uCc&roomIds=GENERAL`.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "wCiXndNp5NqNY3uCc"
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "usersWaitingForE2EKeys": {
                      "type": "object",
                      "description": "An object keyed by room ID. Each value lists the users waiting for that room's key.",
                      "additionalProperties": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "_id": {
                              "type": "string"
                            },
                            "public_key": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "success": {
                      "type": "boolean"
                    }
                  }
                },
                "examples": {
                  "Success Example": {
                    "value": {
                      "usersWaitingForE2EKeys": {
                        "wCiXndNp5NqNY3uCc": [
                          {
                            "_id": "XycfA5CetCPuEjqxw",
                            "public_key": "{\"alg\":\"RSA-OAEP-256\",\"e\":\"AQAB\",\"ext\":true,\"key_ops\":[\"encrypt\"],\"kty\":\"RSA\",\"n\":\"oMO9ydjRxD3JzcAgMvyBZAc_pIOBIxOLVUChZ8mB3JNtLREC751hHT\"}"
                          }
                        ]
                      },
                      "success": true
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    },
                    "errorType": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "Invalid Params": {
                    "value": {
                      "success": false,
                      "error": "must have required property 'roomIds'",
                      "errorType": "error-invalid-params"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/authorizationError"
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "X-User-Id": {
        "name": "X-User-Id",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string"
        },
        "example": "CkCPNctrgCDfmWLqC",
        "description": "The user ID."
      },
      "X-Auth-Token": {
        "name": "X-Auth-Token",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string"
        },
        "example": "1Dd4iN_ClKn5jl-xPC36snQ4s9Zd5GZnXCQuCNSKcVE",
        "description": "The authentication token."
      }
    },
    "responses": {
      "authorizationError": {
        "description": "Unauthorized",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "success": {
                  "type": "boolean"
                },
                "error": {
                  "type": "string"
                }
              }
            },
            "examples": {
              "Authorization Error": {
                "value": {
                  "success": false,
                  "error": "You must be logged in to do this."
                }
              }
            }
          }
        }
      }
    }
  }
}
````