Consultar estado de guía individual

Consulta el estado de una guía específica de Coordinadora.

GET /guias/estado/{guia} v1.0.0
Autenticación
Bearer Token, API Key
Ambiente
Servidor de Desarrollo, Servidor de Producción

Descripción

Consulta el estado de una guía específica de Coordinadora.

El endpoint permite consultar información detallada de una guía incluyendo:

  • Estado actual de la guía
  • Fecha y hora del último evento
  • ID del estado (opcional mediante parámetro)

Ejemplo de Uso

curl --location 'https://api-dev.coordinadora.tech/mio/guias/estado/12345678910' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'x-timestamp: 2024-01-15T10:30:45.123Z' \
--header 'x-app-sources: web-app'

Quick Start

  1. Obtén tus credenciales de acceso (Bearer Token, API Key).
  2. Selecciona el ambiente y completa los parámetros requeridos.
  3. Envía la solicitud y procesa la respuesta.

Ejemplo rápido

Generando ejemplo…

Endpoint

GET /guias/estado/{guia}

Base URL https://api-dev.coordinadora.tech/mio

Parámetros

Nombre Tipo Requerido Descripción
guia path string Número de guía de exactamente 11 dígitos numéricos
id query boolean No Incluir id_estado en la respuesta

Respuesta

200
Consulta exitosa
{
    "response": {
        "isError": false,
        "message": "Consulta de estado de la guía realizada exitosamente",
        "data": {
            "guia": "12345678910",
            "estado": "Entregada",
            "fecha_hora_evento": "2024-10-11T11:16:09.448Z",
            "id_estado": 9
        },
        "timestamp": "2025-01-08T15:52:03.097Z"
    }
}

Ejemplo de respuesta

200 Consulta exitosa
{
    "response": {
        "isError": false,
        "message": "Consulta de estado de la guía realizada exitosamente",
        "data": {
            "guia": "12345678910",
            "estado": "Entregada",
            "fecha_hora_evento": "2024-10-11T11:16:09.448Z",
            "id_estado": 9
        },
        "timestamp": "2025-01-08T15:52:03.097Z"
    }
}

Errores

400
Error de validación
{
    "response": {
        "isError": true,
        "message": "No fue posible realizar la consulta el formato de entrada no corresponde con el esquema definido",
        "data": null,
        "timestamp": "2024-01-15T10:30:00.000Z"
    }
}
401
Error de autenticación
[]
500
Error interno del servidor
[]