Skip to main content

List Missions

Retrieve missions with pagination and filtering options, or get all missions for a specific request.

GET /mision

List missions with pagination and multiple filter options.

Query Parameters

pagina
integer
default:"1"
Page number. Must be >= 1.
porPagina
integer
default:"10"
Records per page. Must be between 1 and 100.
idSolicitud
integer
Filter by request ID.
idEstadoMision
integer
Filter by mission state ID.
codigoEstado
string
Filter by state code (e.g., PROGRAMADA, EN_EJECUCION, COMPLETADA, CANCELADA).
idVehiculo
integer
Filter by assigned vehicle ID.
idMotorista
integer
Filter by assigned driver ID.
fechaDesde
string
Filter by start date in YYYY-MM-DD format.
fechaHasta
string
Filter by end date in YYYY-MM-DD format.
busqueda
string
General search term.

Response

success
boolean
Indicates if the request was successful.
message
string
Response message: “Listado de misiones obtenido exitosamente”
data
object
Paginated mission data.
curl -X GET "https://api.example.com/mision?pagina=1&porPagina=10"
{
  "success": true,
  "message": "Listado de misiones obtenido exitosamente",
  "data": {
    "items": [
      {
        "idMision": 1,
        "idSolicitud": 1,
        "idVehiculoAsignado": 1,
        "idMotoristaAsignado": 5,
        "descripcion": "Traslado de personal al aeropuerto",
        "fechaProgramada": "2025-06-15",
        "horaSalidaProgramada": "08:00:00",
        "idEstadoMision": 2,
        "codigoEstado": "EN_EJECUCION"
      }
    ],
    "total": 45,
    "pagina": 1,
    "porPagina": 10,
    "totalPaginas": 5
  }
}

GET /mision/por-solicitud/

List all active missions for a specific request, including stops.

Path Parameters

id
integer
required
ID of the request to get missions for.

Response

success
boolean
Indicates if the request was successful.
message
string
Response message: “Misiones de la solicitud obtenidas exitosamente”
data
array
Array of mission objects with stops included.
curl -X GET "https://api.example.com/mision/por-solicitud/1"
{
  "success": true,
  "message": "Misiones de la solicitud obtenidas exitosamente",
  "data": [
    {
      "idMision": 1,
      "idSolicitud": 1,
      "descripcion": "Traslado de personal al aeropuerto",
      "fechaProgramada": "2025-06-15",
      "horaSalidaProgramada": "08:00:00",
      "idEstadoMision": 2,
      "codigoEstado": "EN_EJECUCION",
      "paradas": [
        {
          "idMisionParada": 1,
          "idLugarDestino": 2,
          "numeroParada": 1,
          "descripcion": "Entrega en sucursal norte",
          "esParadaFinal": false,
          "fechaHoraLlegadaEstimada": "2025-06-15 09:30:00"
        }
      ]
    }
  ]
}

Build docs developers (and LLMs) love