Saltar al contenido principal
GET
/
api
/
group
/
requests
/
:instance
Solicitudes pendientes
curl --request GET \
  --url https://api.example.com/api/group/requests/:instance \
  --header 'token: <token>'
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí

​
Descripción

Lista las solicitudes de unión pendientes en un grupo que tiene requireAdminApproval=true. Solo los administradores del grupo pueden ver esta cola. Para aceptar o rechazar, usa POST /participants con action=approve o action=reject.

​
Ejemplos

​
Listar solicitudes

Devuelve la cola de solicitudes pendientes para el grupo 120363406289005073@g.us. Cada entrada lleva el LID y (cuando está disponible) el número de teléfono de quien pidió unirse. 
curl -X GET "https://ryzeapi.cloud/api/group/requests/$Instance_Name?identifier=120363406289005073@g.us" \
  -H "token: $Token_Instance"

​
Respuesta exitosa

Devuelve la cola de solicitudes pendientes bajo requests[], con meta.total reportando su tamaño. Cada entrada lleva el jid en formato LID (@lid, para preservar la privacidad del solicitante) y, cuando está disponible, el phoneNumber correspondiente. Usa estos identificadores en /participants con action=approve o action=reject para resolver cada solicitud.
200 OK
{
  "success": true,
  "message": "2 pending requests found",
  "groupJid": "120363406289005073@g.us",
  "requests": [
    {
      "jid": "199789077627112@lid",
      "phoneNumber": "5511999999999@s.whatsapp.net",
      "requestedAt": "2026-04-20T14:00:00Z"
    }
  ],
  "meta": { "total": 2 }
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Cabeceras

​
token
string
requerido
TokenAccount o TokenInstance.

​
Query

​
identifier
string
requerido
JID, código de invitación o enlace del grupo.

​
Notas

  • El jid devuelto viene en formato LID (@lid) para preservar la privacidad del solicitante, en algunos casos phoneNumber puede venir como null.
  • Para aprobar o rechazar en bloque, reenvía estos JIDs (o PNs) a /participants.

​
Errores

HTTPMensaje
400Identifier is required
403Not authorized to view group requests (must be admin)
404Group not found or you are not a member of this group
Envoltorio: 
{
  "success": false,
  "error": { "message": "Not authorized to view group requests (must be admin)" }
}

​
Siguiente

Aprobar / rechazar

Usa action=approve o action=reject en /api/group/participants.

Actualizar grupo

Habilita o deshabilita requireAdminApproval.