1. Posición en vivo
Estarter
  • Documentación
  • Endpoints Estarter [external]
    • Servicios
      • Obtener opciones de filtros disponibles
      • Listar servicios con filtros
    • Microservicios
      • Almacenar archivo PDF
    • Vehiculos
      • vehiculos GPS
        • Lista la última posición GPS de toda la flota activa
        • Última posición GPS de un vehículo específico
      • Catálogo de Vehículos
        • Crear vehículo en catálogo
        • Listar vehículos del catálogo
        • Editar vehículo del catálogo
      • Documentos
        • Obtener datos de preoperacional con paginación y filtros
      • Crear vehículo desde RUNT
      • Obtener vehiculos
      • Vehículos filtros
    • Usuarios
      • Auth Admin
    • Proveedores
      • Agregar o remover proveedor
    • Reservas
      • Obtener reservas por EID y fechas
    • Ultra
      • Listar catálogo de vehículos Ultra
      • Crear solicitud de servicio VIP
    • Date server
      GET
    • Invalidar cache
      GET
    • Auth External
      POST
  • Polaris
    • Posición en vivo
      • Estado completo de una placa
        GET
      • Estado lite de varias placas (lote)
        GET
      • Snapshot de toda la flota (lite)
        GET
    • Geoespacial
      • Vehículos dentro de un radio
      • Vehículos dentro de un bounding box
    • Histórico
      • Trazado (readings) por placa y rango
    • Tiempo real
      • Stream SSE de posición en vivo (push)
  • Schemas
    • Sample Schemas
      • Pet
      • Category
    • Schemas
      • CrearVehiculoRequest
      • EditarVehiculoRequest
      • VehiculoResponse
      • ListarVehiculosResponse
    • Raíz
      • PreoperacionalRequest
      • CatalogoVehiculosResponse
      • SolicitudVipRequest
      • ListarServiciosRequest
      • PreoperacionalResponse
      • DatosSolicitante
      • ListarServiciosResponse
      • Tag
      • Vehiculo
      • PreoperacionalData
      • TarifaServicio
      • SolicitudVipResponse
      • Servicio
      • Paginacion
      • SolicitudVipData
      • FiltrosServiciosRequest
      • FiltrosServiciosResponse
      • ErrorResponse
      • UnauthorizedResponse
      • RateLimitResponse
    • GpsVehiculo
    • SourceKind
    • RangoBusqueda
    • Mode
    • GpsListaMetadata
    • CanonLite
    • GpsListaResponse
    • SourceSnapshot
    • GpsPlacaResponse
    • PlacaState
    • ErrorAuth
    • Reading
    • Error
  1. Posición en vivo

Estado completo de una placa

GET
/v1/state/{placa}
Devuelve el estado dual-source completo de un vehículo: la posición
canonical (la elegida) más las fuentes phone y device, el mode
de resolución y la razón del último cambio. Útil para diagnóstico.
Para fan-out masivo preferí GET /v1/all o GET /v1/states (lite).

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros de ruta

Ejemplos de solicitud

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/v1/state/PUP074' \
--header 'Authorization: Bearer <token>'

Respuestas

🟢200OK
application/json
Estado del vehículo (puede tener fuentes en null si no reportan).
Bodyapplication/json

Ejemplo
{
    "canonical": {
        "source": "zonar",
        "ts": 1780970872000,
        "lat": 3.440298,
        "lng": -76.500808,
        "accuracy": 10,
        "speed": 8.6,
        "heading": 64,
        "provider": "zonar"
    },
    "device": {
        "source": "zonar",
        "ts": 1780970872000,
        "lat": 3.440298,
        "lng": -76.500808,
        "accuracy": 10,
        "speed": 8.6,
        "heading": 64,
        "provider": "zonar"
    },
    "phone": null,
    "canonicalReason": "device_fresh",
    "mode": "device_only",
    "lastSwitchAt": 1780970000000,
    "phoneLockedUntil": 0,
    "divergenceM": 0,
    "pendingSwitch": null,
    "phoneAbandonedAt": 0
}
🟠400Petición incorrecta
🟠401No autorizado
Modificado en 2026-06-09 20:26:25
Anterior
Auth External
Siguiente
Estado lite de varias placas (lote)
Built with