Get Employee by ID

Retrieve a specific employee’s profile by their ID (Admin only)

GET /api/empleados/:idEmpleado

Get Employee by ID

cURL

curl --request GET \
  --url https://api.example.com/api/empleados/:idEmpleado \
  --header 'Authorization: <authorization>'

200

{
  "id_empleado": 123,
  "nombre": "<string>",
  "DNI": "<string>",
  "correo": "<string>",
  "telefono": "<string>",
  "direccion": "<string>",
  "fecha_ingreso": "<string>",
  "fecha_salida": "<string>",
  "puesto": "<string>",
  "img_perfil": "<string>",
  "azure_oid": "<string>",
  "id_rol": 123,
  "id_estado": 123,
  "id_clinica": 123,
  "id_area": 123,
  "total_solicitudes": 123,
  "solicitudes_pendientes": 123,
  "clinica": {
    "nombre_clinica": "<string>"
  },
  "estado_empleado": {
    "descripcion": "<string>"
  },
  "rol": {
    "descripcion": "<string>"
  },
  "vacaciones": [
    {
      "dias_base": 123,
      "dias_tomados": 123,
      "dias_disponibles": 123
    }
  ]
}

Overview

This endpoint allows administrators to retrieve detailed profile information for any employee by their employee ID. It returns the same comprehensive data structure as the profile endpoint, including clinic, role, vacation, and request statistics.

Admin Access Required

This endpoint requires administrator privileges. Only users with admin role can access other employees’ profiles.

Request

curl -X GET 'https://api.yourcompany.com/api/empleados/42' \
  -H 'Authorization: Bearer YOUR_ADMIN_JWT_TOKEN'

Path Parameters

idEmpleado · integer · required

The unique identifier of the employee to retrieve. Must be a valid numeric ID.

Headers

Authorization · string · required

Bearer token from Azure AD authentication with admin privileges

Response

id_empleado · integer

Unique employee identifier

nombre · string

Employee’s full name

DNI · string

Employee’s national ID number

correo · string

Employee’s email address

telefono · string

Employee’s phone number

direccion · string

Employee’s physical address

fecha_ingreso · string

Date the employee joined (format: YYYY-MM-DD)

fecha_salida · string

Date the employee left (null if currently active)

puesto · string

Employee’s job position/title

img_perfil · string

URL or path to profile image

azure_oid · string

Azure AD Object ID for integration

id_rol · integer

Foreign key to employee role

id_estado · integer

Foreign key to employee status

id_clinica · integer

Foreign key to assigned clinic

id_area · integer

Foreign key to department/area

total_solicitudes · integer

Total number of requests submitted by this employee

solicitudes_pendientes · integer

Number of pending requests awaiting approval

clinica · object

Show properties

nombre_clinica · string

Name of the assigned clinic

estado_empleado · object

Show properties

descripcion · string

Employee status description (e.g., “Activo”, “Inactivo”)

rol · object

Show properties

descripcion · string

Role description (e.g., “Administrador”, “Empleado”, “Gerente”)

vacaciones · array

Array of vacation records for the employee

Show properties

dias_base · integer

Base vacation days allocated per period

dias_tomados · integer

Number of vacation days already taken

dias_disponibles · integer

Remaining vacation days available

Response Example

200 - Success

{
  "id_empleado": 42,
  "nombre": "María González",
  "DNI": "87654321",
  "correo": "[e-mail]",
  "telefono": "[phone]",
  "direccion": "Jr. Los Olivos 456, Lima",
  "fecha_ingreso": "2022-03-10",
  "fecha_salida": null,
  "puesto": "Gerente de Operaciones",
  "img_perfil": "/images/profiles/maria.jpg",
  "azure_oid": "b2c3d4e5-f6a7-8901-bcde-fa2345678901",
  "id_rol": 2,
  "id_estado": 1,
  "id_clinica": 3,
  "id_area": 5,
  "total_solicitudes": 28,
  "solicitudes_pendientes": 3,
  "clinica": {
    "nombre_clinica": "Clínica San Juan"
  },
  "estado_empleado": {
    "descripcion": "Activo"
  },
  "rol": {
    "descripcion": "Gerente"
  },
  "vacaciones": [
    {
      "dias_base": 25,
      "dias_tomados": 10,
      "dias_disponibles": 15
    }
  ]
}

Error Handling

400 Bad Request

The provided employee ID is not a valid number

403 Forbidden

User does not have administrator privileges to access this endpoint

404 Not Found

No employee exists with the specified ID

500 Internal Error

Database connection issues or unexpected server errors

Input Validation

The endpoint performs basic sanitization:

• ID Validation: Ensures idEmpleado is a numeric value
• Type Safety: Non-numeric values are rejected with a 400 error
• SQL Injection Protection: Uses parameterized queries through Sequelize ORM

Use Cases

Admin Dashboard

View detailed employee information in administrative interfaces

Request Management

Access employee details when reviewing their submitted requests

HR Operations

Manage employee records and track vacation balances

Reporting

Generate reports with comprehensive employee data