Skip to main content

Endpoint

GET /api/profiles

Description

Retrieves a list of all user profiles registered in the system. This endpoint is restricted to administrators only. See implementation in server/src/modules/profiles/profiles.controller.ts:14-24.

Authentication

This endpoint requires both Bearer token authentication AND admin role (RolesGuard). Standard users will receive a 403 Forbidden response.

Request

No parameters required.

Response

data
array
Array of profile objects

Success Response (200)

[
  {
    "id": "abc123",
    "email": "[email protected]",
    "full_name": "Dr. Jane Smith",
    "role": "ADMIN",
    "is_active": true,
    "birth_date": "1985-03-15",
    "is_profile_complete": true,
    "created_at": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": "def456",
    "email": "[email protected]",
    "full_name": "John Doe",
    "role": "USER",
    "is_active": true,
    "birth_date": "1990-07-22",
    "is_profile_complete": true,
    "created_at": "2024-02-01T14:20:00.000Z"
  }
]

Error Responses

401 Unauthorized

{
  "statusCode": 401,
  "message": "Token inválido o expirado",
  "error": "Unauthorized"
}
Missing or invalid Bearer token.

403 Forbidden

{
  "statusCode": 403,
  "message": "No tenés permisos para acceder a este recurso.",
  "error": "Forbidden"
}
User does not have admin role.

Code Examples

curl -X GET https://api.zenda.com/api/profiles \
  -H "Authorization: Bearer YOUR_TOKEN"

Use Cases

  • Admin dashboard showing all users
  • User management interface
  • Generating reports on user base
  • Monitoring account statuses
  • Verifying profile completion rates

Get One Profile

Retrieve a specific user profile by ID

Update Profile

Update profile information

Build docs developers (and LLMs) love