> ## Documentation Index
> Fetch the complete documentation index at: https://help.impactu.colav.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar usuarios

> Devuelve la lista de todos los usuarios de la plataforma (excluye cuentas admin). Solo accesible con rol admin.

> [!NOTE]
>
> Requiere sesión activa con rol `admin`. El JWT se lee desde la cookie
> `access_token_cookie`.

## Respuesta

**success** `boolean`

`true` si la operación fue exitosa.

**data** `object[]`

Lista de usuarios.

**propiedades de cada usuario**

**id** `string`

Identificador ROR de la institución del usuario.

**email** `string`

Correo electrónico.

**institution** `string`

Nombre de la institución.

**role** `string`

Rol del usuario.

**is\_active** `boolean`

Indica si la cuenta está activa.

```json 200 theme={null}
{
  "success": true,
  "data": [
    {
      "id": "example-institution-id",
      "email": "usuario@example.com",
      "institution": "Universidad Ejemplo",
      "role": "staff",
      "is_active": true
    }
  ]
}
```

```json 401 theme={null}
{"msg": "Token no proporcionado o inválido. Por favor, inicia sesión nuevamente.", "success": false}
```

```json 403 theme={null}
{ "success": false, "msg": "Permiso denegado: No pueden realizar esta acción." }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.