Skip to main content
GET
/
usuarios
/
listar
List Users
curl --request GET \
  --url https://api.example.com/usuarios/listar
[
  {
    "id": "507f1f77bcf86cd799439011",
    "nombre": "Juan Pérez",
    "email": "[email protected]",
    "rol": "visitante",
    "favoritos": ["507f191e810c19729de860ea", "507f191e810c19729de860eb"],
    "pois_visitados": ["507f191e810c19729de860ea"],
    "rutas_recorridas": [
      {
        "ruta_id": "507f191e810c19729de860ec",
        "fecha": "2024-03-15T10:30:00Z"
      }
    ],
    "fecha_creacion": "2024-01-10T08:00:00Z"
  },
  {
    "id": "507f1f77bcf86cd799439012",
    "nombre": "María González",
    "email": "[email protected]",
    "rol": "editor",
    "favoritos": [],
    "pois_visitados": [],
    "rutas_recorridas": [],
    "fecha_creacion": "2024-02-20T14:15:00Z"
  }
]

Authentication

This endpoint requires admin authentication. Include a valid JWT token with admin role in the Authorization header.
Authorization: Bearer <admin_jwt_token>

Response

users
array
Array of user objects
[
  {
    "id": "507f1f77bcf86cd799439011",
    "nombre": "Juan Pérez",
    "email": "[email protected]",
    "rol": "visitante",
    "favoritos": ["507f191e810c19729de860ea", "507f191e810c19729de860eb"],
    "pois_visitados": ["507f191e810c19729de860ea"],
    "rutas_recorridas": [
      {
        "ruta_id": "507f191e810c19729de860ec",
        "fecha": "2024-03-15T10:30:00Z"
      }
    ],
    "fecha_creacion": "2024-01-10T08:00:00Z"
  },
  {
    "id": "507f1f77bcf86cd799439012",
    "nombre": "María González",
    "email": "[email protected]",
    "rol": "editor",
    "favoritos": [],
    "pois_visitados": [],
    "rutas_recorridas": [],
    "fecha_creacion": "2024-02-20T14:15:00Z"
  }
]

Code Examples

curl -X GET "https://api.tesisrutas.com/usuarios/listar" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Error Responses

403
error
Forbidden - User does not have admin privileges
{
  "detail": "No tienes permisos de administrador"
}
401
error
Unauthorized - Missing or invalid JWT token
{
  "detail": "Not authenticated"
}

Implementation Details

Source: src/infrastructure/api/routers/usuario_router.py:83-87 This endpoint uses the ListarUsuarios use case to fetch all users from the MongoDB usuarios collection. The response includes complete user profiles with activity tracking data.

Build docs developers (and LLMs) love