Skip to main content
GET
/
solicitud
curl -X GET "https://api.example.com/solicitud?pagina=1&por_pagina=20&codigoEstado=PENDIENTE_APROBACION&idDepartamento=2" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "success": true,
  "message": "Listado de solicitudes obtenido exitosamente",
  "data": {
    "total": 45,
    "pagina": 1,
    "porPagina": 20,
    "registros": [
      {
        "Id": 42,
        "CodigoSolicitud": "SOL-2026-03-00000042",
        "IdUsuarioSolicitante": 1,
        "NombreSolicitante": "Juan Pérez",
        "EmailSolicitante": "[email protected]",
        "IdDepartamentoSolicitante": 2,
        "NombreDepartamento": "Logística",
        "IdUsuarioAprobador": 3,
        "NombreAprobador": "María González",
        "EmailAprobador": "[email protected]",
        "IdTipoPrioridadSolicitud": 2,
        "NombrePrioridad": "Normal",
        "IdTipoServicioSolicitud": 1,
        "NombreTipoServicio": "Transporte de personal",
        "Asunto": "Transporte de personal a sede central",
        "Descripcion": "Se requiere transporte para personal de la unidad",
        "CantidadPasajeros": 5,
        "FechaServicioRequerido": "2026-04-15",
        "HoraServicioRequerido": "08:00:00",
        "IdEstadoActual": 1,
        "CodigoEstadoActual": "PENDIENTE_APROBACION",
        "NombreEstadoActual": "Pendiente de Aprobación",
        "ColorEstadoActual": "#FFA500",
        "EsEstadoFinal": false,
        "FechaHoraCreacion": "2026-03-10T14:30:00",
        "FechaHoraActualizacion": "2026-03-10T14:30:00",
        "lugares": [
          {
            "Id": 1,
            "IdLugar": 5,
            "NombreLugar": "Sede Central",
            "DireccionLugar": "Av. Principal 123",
            "EsOrigen": true,
            "Orden": 0
          }
        ]
      }
    ]
  }
}

​
Overview

Retrieves a paginated list of solicitudes with support for multiple filters. This endpoint also supports an unpaginated version at /solicitud/todos/lista.

​
Authentication

Requires valid authentication token.

​
Query Parameters

​
Pagination

​
pagina
integer
default:1
Page number (minimum 1)
​
por_pagina
integer
default:10
Records per page (minimum 1, maximum 100)

​
Filters

​
idEstadoSolicitud
integer
Filter by status ID (exact match)
​
codigoEstado
string
Filter by status code (e.g., PENDIENTE_APROBACION, APROBADA, RECHAZADA, CANCELADA, COMPLETADA)
​
idDepartamento
integer
Filter by requesting department ID
​
idUsuarioSolicitante
integer
Filter by requester user ID
​
idUsuarioAprobador
integer
Filter by approver user ID
​
idTipoServicio
integer
Filter by service type ID
​
idTipoPrioridad
integer
Filter by priority type ID
​
fechaDesde
date
Filter by service date from (YYYY-MM-DD format)
​
fechaHasta
date
Filter by service date to (YYYY-MM-DD format)
​
busqueda
string
Search in solicitud code, subject, and description (partial match)

​
Unpaginated Endpoint

GET /solicitud/todos/lista Returns all active solicitudes without pagination. Accepts the same filter parameters as the paginated endpoint (excluding pagina and por_pagina).

​
Response

​
success
boolean
Indicates if the operation was successful
​
message
string
Success message
​
data
object
Pagination and results data
For the unpaginated endpoint /solicitud/todos/lista, the response data is an array of solicitudes directly (no pagination metadata).

​
Status Codes

​
200
OK
Solicitudes retrieved successfully
​
500
Internal Server Error
Server error
curl -X GET "https://api.example.com/solicitud?pagina=1&por_pagina=20&codigoEstado=PENDIENTE_APROBACION&idDepartamento=2" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "success": true,
  "message": "Listado de solicitudes obtenido exitosamente",
  "data": {
    "total": 45,
    "pagina": 1,
    "porPagina": 20,
    "registros": [
      {
        "Id": 42,
        "CodigoSolicitud": "SOL-2026-03-00000042",
        "IdUsuarioSolicitante": 1,
        "NombreSolicitante": "Juan Pérez",
        "EmailSolicitante": "[email protected]",
        "IdDepartamentoSolicitante": 2,
        "NombreDepartamento": "Logística",
        "IdUsuarioAprobador": 3,
        "NombreAprobador": "María González",
        "EmailAprobador": "[email protected]",
        "IdTipoPrioridadSolicitud": 2,
        "NombrePrioridad": "Normal",
        "IdTipoServicioSolicitud": 1,
        "NombreTipoServicio": "Transporte de personal",
        "Asunto": "Transporte de personal a sede central",
        "Descripcion": "Se requiere transporte para personal de la unidad",
        "CantidadPasajeros": 5,
        "FechaServicioRequerido": "2026-04-15",
        "HoraServicioRequerido": "08:00:00",
        "IdEstadoActual": 1,
        "CodigoEstadoActual": "PENDIENTE_APROBACION",
        "NombreEstadoActual": "Pendiente de Aprobación",
        "ColorEstadoActual": "#FFA500",
        "EsEstadoFinal": false,
        "FechaHoraCreacion": "2026-03-10T14:30:00",
        "FechaHoraActualizacion": "2026-03-10T14:30:00",
        "lugares": [
          {
            "Id": 1,
            "IdLugar": 5,
            "NombreLugar": "Sede Central",
            "DireccionLugar": "Av. Principal 123",
            "EsOrigen": true,
            "Orden": 0
          }
        ]
      }
    ]
  }
}

​
Filtering Examples

​
Filter by Status

GET /solicitud?codigoEstado=PENDIENTE_APROBACION

​
Filter by Department and Date Range

GET /solicitud?idDepartamento=2&fechaDesde=2026-03-01&fechaHasta=2026-03-31

​
Search and Filter by Priority

GET /solicitud?busqueda=transporte&idTipoPrioridad=1

​
Get All Approved Solicitudes (Unpaginated)

GET /solicitud/todos/lista?codigoEstado=APROBADA

Build docs developers (and LLMs) love

Get started for freeTalk to us