Get Requests

Retrieve requests with pagination, filtering, and role-based access control

GET /api/solicitudes

Get Requests

cURL

curl --request GET \
  --url https://api.example.com/api/solicitudes

403 Forbidden

{
  "message": "Tipo de rol (unknown) no soportado."
}

Endpoint

GET /api/solicitudes

Authentication

Requires JWT authentication. The endpoint returns different data based on user role:

Employee

Returns only their own requests

Admin

Returns all requests except canceled ones

Super Admin

Returns all requests including canceled

Query Parameters

page · number · default: "1"

Page number for pagination

limit · number · default: "25"

Number of items per page

id_estado · number

Filter by request state:

• 1: Pending
• 2: Approved
• 3: Rejected
• 4: Canceled

id_tipo · number

Filter by request type:

• 1: Vacation
• 2: Permission
• 3: Absence
• 4: Remote Work
• 5: Profile Update

search · string

Text search across request fields

start_date · string

Filter requests starting from this date (YYYY-MM-DD)

end_date · string

Filter requests up to this date (YYYY-MM-DD)

Response

status · string

Status of the response (“success”)

data · object

Show properties

solicitudes · array

Array of request objects

Show Request Object

id_solicitud · number

Unique request identifier

id_empleado · number

Employee ID who created the request

id_tipo_solicitud · number

Type of request (1-5)

id_estado_solicitud · number

Current state (1-4)

fecha_inicio · string

Start date (YYYY-MM-DD HH:mm:ss)

fecha_fin · string

End date (YYYY-MM-DD HH:mm:ss)

dias_solicitados · number

Number of days requested

descripcion_solicitud · string

Request description

documento_url · string

URL to supporting document (optional)

pagination · object

Show properties

total · number

Total number of requests

page · number

Current page number

limit · number

Items per page

totalPages · number

Total number of pages

Code Examples

JavaScript

const token = 'your_jwt_token';

const response = await fetch('/api/solicitudes?page=1&limit=10&id_estado=1', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Response Example

{
  "status": "success",
  "data": {
    "solicitudes": [
      {
        "id_solicitud": 123,
        "id_empleado": 45,
        "id_tipo_solicitud": 1,
        "id_estado_solicitud": 1,
        "fecha_inicio": "2026-04-01 00:00:00",
        "fecha_fin": "2026-04-05 00:00:00",
        "dias_solicitados": 5,
        "descripcion_solicitud": "Vacation request for April",
        "documento_url": null
      }
    ],
    "pagination": {
      "total": 45,
      "page": 1,
      "limit": 10,
      "totalPages": 5
    }
  }
}

Error Responses

403 Forbidden

{
  "message": "Tipo de rol (unknown) no soportado."
}

Additional Endpoints

Get Single Request

GET /api/solicitudes/:id

Retrieve detailed information about a specific request. Employees can only view their own requests; admins can view any request.

Get Pending Requests

GET /api/solicitudes/admin/pendientes

Admin-only endpoint to retrieve all pending requests. Supports the same query parameters as the main endpoint (except id_estado).