Skip to main content
GET
/
api
/
solicitudes
Get Requests
curl --request GET \
  --url https://api.example.com/api/solicitudes
{
  "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
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

Code Examples

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

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

Additional Endpoints

Get Single Request

GET /api/solicitudes/:idRetrieve 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/pendientesAdmin-only endpoint to retrieve all pending requests. Supports the same query parameters as the main endpoint (except id_estado).

Build docs developers (and LLMs) love