Skip to main content
GET
/
solicitud
/
{id}
/
historico
curl -X GET https://api.example.com/solicitud/42/historico \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "success": true,
  "message": "Histórico de estados obtenido exitosamente",
  "data": {
    "idSolicitud": 42,
    "codigoSolicitud": "SOL-2026-03-00000042",
    "historico": [
      {
        "IdEstadoSolicitud": 1,
        "IdSolicitud": 42,
        "CodigoEstado": "PENDIENTE_APROBACION",
        "NombreEstado": "Pendiente de Aprobación",
        "ColorEstado": "#FFA500",
        "OrdenEstado": 1,
        "EsEstadoFinal": false,
        "MotivoEstadoSolicitud": "Solicitud creada",
        "FechaHoraCreacion": "2026-03-10T14:30:00",
        "FechaHoraActualizacion": "2026-03-10T14:30:00"
      },
      {
        "IdEstadoSolicitud": 2,
        "IdSolicitud": 42,
        "CodigoEstado": "APROBADA",
        "NombreEstado": "Aprobada",
        "ColorEstado": "#00FF00",
        "OrdenEstado": 2,
        "EsEstadoFinal": false,
        "MotivoEstadoSolicitud": "Solicitud cumple con todos los requisitos institucionales",
        "FechaHoraCreacion": "2026-03-10T15:45:00",
        "FechaHoraActualizacion": "2026-03-10T15:45:00"
      },
      {
        "IdEstadoSolicitud": 5,
        "IdSolicitud": 42,
        "CodigoEstado": "COMPLETADA",
        "NombreEstado": "Completada",
        "ColorEstado": "#0000FF",
        "OrdenEstado": 5,
        "EsEstadoFinal": true,
        "MotivoEstadoSolicitud": "Todas las misiones completadas exitosamente",
        "FechaHoraCreacion": "2026-04-15T18:30:00",
        "FechaHoraActualizacion": "2026-04-15T18:30:00"
      }
    ]
  }
}

​
Overview

Retrieves the complete history of status changes for a specific solicitud, ordered chronologically from oldest to newest.

​
Authentication

Requires valid authentication token.

​
Path Parameters

​
id_solicitud
integer
required
The unique ID of the solicitud

​
Response

​
success
boolean
Indicates if the operation was successful
​
message
string
Success message
​
data
object
History data object

​
Status Codes

​
200
OK
History retrieved successfully
​
404
Not Found
Solicitud with the specified ID does not exist
​
500
Internal Server Error
Server error
curl -X GET https://api.example.com/solicitud/42/historico \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "success": true,
  "message": "Histórico de estados obtenido exitosamente",
  "data": {
    "idSolicitud": 42,
    "codigoSolicitud": "SOL-2026-03-00000042",
    "historico": [
      {
        "IdEstadoSolicitud": 1,
        "IdSolicitud": 42,
        "CodigoEstado": "PENDIENTE_APROBACION",
        "NombreEstado": "Pendiente de Aprobación",
        "ColorEstado": "#FFA500",
        "OrdenEstado": 1,
        "EsEstadoFinal": false,
        "MotivoEstadoSolicitud": "Solicitud creada",
        "FechaHoraCreacion": "2026-03-10T14:30:00",
        "FechaHoraActualizacion": "2026-03-10T14:30:00"
      },
      {
        "IdEstadoSolicitud": 2,
        "IdSolicitud": 42,
        "CodigoEstado": "APROBADA",
        "NombreEstado": "Aprobada",
        "ColorEstado": "#00FF00",
        "OrdenEstado": 2,
        "EsEstadoFinal": false,
        "MotivoEstadoSolicitud": "Solicitud cumple con todos los requisitos institucionales",
        "FechaHoraCreacion": "2026-03-10T15:45:00",
        "FechaHoraActualizacion": "2026-03-10T15:45:00"
      },
      {
        "IdEstadoSolicitud": 5,
        "IdSolicitud": 42,
        "CodigoEstado": "COMPLETADA",
        "NombreEstado": "Completada",
        "ColorEstado": "#0000FF",
        "OrdenEstado": 5,
        "EsEstadoFinal": true,
        "MotivoEstadoSolicitud": "Todas las misiones completadas exitosamente",
        "FechaHoraCreacion": "2026-04-15T18:30:00",
        "FechaHoraActualizacion": "2026-04-15T18:30:00"
      }
    ]
  }
}

​
Use Cases

​
Audit Trail

The history endpoint provides a complete audit trail of all status changes, including:
  • Who initiated each change (via the change reason)
  • When each change occurred
  • Why the change was made (via the optional reason field)

​
Status Timeline

Display a visual timeline of the solicitud’s lifecycle:
  1. Creation (PENDIENTE_APROBACION)
  2. Approval/Rejection decision
  3. Cancellation (if applicable)
  4. Completion (if approved and all missions completed)

​
Transparency

Provide users with full visibility into the decision-making process and status progression.

​
Common Status Flows

​
Approved and Completed

PENDIENTE_APROBACION → APROBADA → COMPLETADA

​
Rejected

PENDIENTE_APROBACION → RECHAZADA

​
Approved then Cancelled

PENDIENTE_APROBACION → APROBADA → CANCELADA

​
Pending then Cancelled

PENDIENTE_APROBACION → CANCELADA
The history is ordered chronologically (oldest first), making it easy to trace the complete lifecycle of a solicitud from creation to its current or final status.

Build docs developers (and LLMs) love

Get started for freeTalk to us