> ## Documentation Index > Fetch the complete documentation index at: https://docs.ugps.io/llms.txt > Use this file to discover all available pages before exploring further. # Obtener paradas entre viajes de un dispositivo > Obtiene todas las paradas entre viajes de un dispositivo específico. Las paradas entre viajes son intervalos de tiempo en los que el vehículo está detenido entre dos viajes consecutivos. Si se proporcionan parámetros de fecha, filtra las paradas por el rango especificado. **Formatos de fecha aceptados:** - `DD/MM/YYYY` - Solo fecha (desde las 00:00:00 hasta las 23:59:59 del día) - `DD/MM/YYYY HH:mm` - Fecha con hora y minutos específicos - `DD/MM/YYYY HH:mm:ss` - Fecha con hora, minutos y segundos específicos **Ejemplos:** - Solo fecha: `01/01/2025` → Desde 01/01/2025 00:00:00 hasta 01/01/2025 23:59:59 - Con hora: `01/01/2025 08:30` → Desde 01/01/2025 08:30:00 - Con hora completa: `01/01/2025 08:30:45` → Desde 01/01/2025 08:30:45 ## OpenAPI ````yaml /openapi.json get /api/trips/{flespiId}/stops openapi: 3.0.0 info: title: UGPS Atlas API version: 1.0.0 description: >- Documentación de la API REST principal de UGPS Atlas (plataforma de rastreo GPS) servers: - url: https://api.ugps.io description: Servidor de producción security: - bearerAuth: [] - cookieAuth: [] tags: - name: Auth - Autenticación description: Operaciones de autenticación - name: Usuarios - Usuarios description: Operaciones relacionadas con usuarios - name: Usuarios - Roles description: Operaciones relacionadas con roles - name: Usuarios - Permisos description: Operaciones relacionadas con permisos - name: Activos - Assets description: Operaciones relacionadas con activos - name: Activos - Tipos description: Operaciones relacionadas con tipos de activos - name: Activos - Grupos description: Operaciones relacionadas con grupos de activos - name: Activos - Vehículos description: Operaciones relacionadas con tipos de vehículos - name: Tracking - Trackers description: Operaciones relacionadas con trackers - name: Tracking - Viajes description: Operaciones relacionadas con viajes y paradas - name: Tracking - Geocercas description: Operaciones relacionadas con geocercas - name: Alertas - Alertas description: Operaciones relacionadas con alertas - name: Alertas - Disparadores description: Operaciones relacionadas con disparadores de alertas - name: Alertas - Notificaciones description: Operaciones relacionadas con notificaciones - name: Clientes - Restricciones description: Operaciones relacionadas con restricciones - name: Integraciones - Flespi description: Operaciones relacionadas con Flespi - name: Integraciones - Vehículo description: Información de vehículo por patente (endpoint genérico) - name: Otros - Conductores description: Operaciones relacionadas con conductores - name: Otros - Capas description: Operaciones relacionadas con capas - name: User Tracker Access description: Operaciones de acceso personalizado a trackers por usuario - name: Reportes - Historial de Posiciones description: Estadísticas y detalle de posiciones GPS por activo - name: Reportes - Excesos de Velocidad description: Reportes de excesos de velocidad por tracker - name: Reportes - Ralentí description: Reportes de ralentí (motor encendido sin movimiento) por tracker - name: Reportes - Horas de Trabajo description: >- Reportes de horas de trabajo (conducción + paradas dentro de horario laboral) por tracker - name: Reportes - Última Actividad description: Reporte de estado de comunicación y última posición de activos - name: Reportes - Reportes Programados description: Gestión de reportes programados (CRUD) - name: Device Health description: Operaciones de salud de dispositivos del cliente - name: Activity Log description: Registro de actividad del cliente - name: Work - Importaciones description: Operaciones de importación de datos - name: Work - Plantillas description: Operaciones de plantillas de importación - name: Cargo - Transportistas description: Gestión de transportistas - name: Cargo - Pedidos description: Gestión de pedidos de carga - name: Cargo - Monitoreo description: Monitoreo en vivo de carga y transporte - name: Integraciones - Navixy description: Integración con plataforma Navixy - name: Mantenimiento - Dashboard description: Dashboard y métricas generales de mantenimiento - name: Mantenimiento - Proveedores description: Gestión de proveedores de servicio - name: Mantenimiento - Estado description: Estado de mantenimiento de activos - name: Mantenimiento - Perfiles description: Perfiles de mantenimiento por activo - name: Mantenimiento - Fallas description: Gestión de fallas activas - name: Mantenimiento - DVIR description: Driver Vehicle Inspection Reports - name: Mantenimiento - Defectos description: Gestión de defectos detectados - name: Mantenimiento - Programaciones description: Programación de mantenimientos preventivos - name: Mantenimiento - Próximos description: Ítems de mantenimiento próximos - name: Mantenimiento - Órdenes de Trabajo description: Gestión de órdenes de trabajo - name: Mantenimiento - Registros de Servicio description: Registros históricos de servicios realizados - name: Mantenimiento - Problemas description: Gestión de problemas de mantenimiento - name: Mantenimiento - Tareas de Servicio description: Tareas específicas dentro de órdenes de trabajo - name: Mantenimiento - Inventario description: Gestión de partes, ubicaciones y stock - name: Mantenimiento - Costos description: Gestión y agregación de costos de mantenimiento - name: Mantenimiento - Importación de Facturas description: Importación de facturas con extracción por IA - name: Trabajo - Tareas description: Gestión de tareas, tareas recurrentes, rutas y operaciones en lote - name: Trabajo - Empleados description: Gestión de empleados, departamentos y sus catálogos (tags, trackers) - name: Otros - Lugares description: Gestión de lugares (places) del cliente - name: Cargo - Activos description: Disponibilidad de activos de carga - name: Cargo - Ubicaciones description: Gestión de ubicaciones de carga - name: Cargo - Rendimiento description: Métricas de rendimiento de pedidos de carga - name: Reportes - Check-ins description: Reporte de check-ins de tareas - name: Reportes - Utilización description: Reporte de utilización de activos - name: Reportes - Visitas por Geocercas description: Reporte de visitas a geocercas - name: Reportes - Visitas por Trackers description: Reporte de visitas por tracker/activo - name: Reportes - Progreso de Geozonas description: Reporte de progreso de cobertura de geozonas (agricultura) - name: Reportes - Temperatura description: Reporte de temperatura por activo - name: Reportes - Exportación description: Exportación de reportes a archivo - name: Público - Business Time description: Reloj de servidor (endpoint público, sin autenticación) - name: Formularios description: Definiciones y envíos de formularios de la app - name: Sistema description: Endpoints de salud del servicio (liveness/readiness), sin autenticación paths: /api/trips/{flespiId}/stops: get: tags: - Tracking - Viajes summary: Obtener paradas entre viajes de un dispositivo description: > Obtiene todas las paradas entre viajes de un dispositivo específico. Las paradas entre viajes son intervalos de tiempo en los que el vehículo está detenido entre dos viajes consecutivos. Si se proporcionan parámetros de fecha, filtra las paradas por el rango especificado. **Formatos de fecha aceptados:** - `DD/MM/YYYY` - Solo fecha (desde las 00:00:00 hasta las 23:59:59 del día) - `DD/MM/YYYY HH:mm` - Fecha con hora y minutos específicos - `DD/MM/YYYY HH:mm:ss` - Fecha con hora, minutos y segundos específicos **Ejemplos:** - Solo fecha: `01/01/2025` → Desde 01/01/2025 00:00:00 hasta 01/01/2025 23:59:59 - Con hora: `01/01/2025 08:30` → Desde 01/01/2025 08:30:00 - Con hora completa: `01/01/2025 08:30:45` → Desde 01/01/2025 08:30:45 parameters: - name: flespiId in: path required: true schema: type: number description: ID del dispositivo en Flespi - in: query name: from required: false schema: type: string description: >- Fecha de inicio. Formatos aceptados - DD/MM/YYYY, DD/MM/YYYY HH:mm, DD/MM/YYYY HH:mm:ss (ejemplo: `01/01/2025` o `01/01/2025 08:30`) example: 01/01/2025 08:30 - in: query name: to required: false schema: type: string description: >- Fecha de fin. Formatos aceptados - DD/MM/YYYY, DD/MM/YYYY HH:mm, DD/MM/YYYY HH:mm:ss (ejemplo: `31/01/2025` o `31/01/2025 17:45`) example: 31/01/2025 17:45 responses: '200': description: Lista de paradas entre viajes del dispositivo obtenida exitosamente content: application/json: schema: type: object properties: status: type: string example: success data: type: array items: type: object properties: active: type: boolean begin: type: integer description: Unix timestamp (segundos) device_id: type: integer duration: type: integer description: segundos end: type: integer description: Unix timestamp (segundos) id: type: integer ident: type: string parking_duration: type: integer description: segundos start: type: object properties: position.latitude: type: number format: double position.longitude: type: number format: double required: - position.latitude - position.longitude timestamp: type: number format: double description: Unix timestamp (segundos) type: type: string example: stops_between_trips address: type: string nullable: true description: Cacheada en Redis example: Av. Principal 123, Lima, Perú required: - active - begin - device_id - duration - end - id - ident - parking_duration - start - timestamp - type '400': description: Error de validación content: application/json: schema: oneOf: - type: object properties: error: type: string example: El email es requerido - type: object properties: status: type: string example: failed message: type: string example: Error de validación errors: type: array items: type: object properties: path: type: string message: type: string '401': description: No autorizado content: application/json: schema: type: object properties: error: type: string example: Token inválido o expirado '404': description: Recurso no encontrado content: application/json: schema: type: object properties: error: type: string example: Recurso no encontrado '500': description: Error interno del servidor content: application/json: schema: oneOf: - type: object properties: message: type: string example: Error interno del servidor - type: object properties: status: type: string example: failed message: type: string example: Error interno del servidor security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- Token de sesión Better Auth o API token (`atk_...`) en el header `Authorization: Bearer `. Los JWT legacy ya no son válidos. cookieAuth: type: apiKey in: cookie name: better-auth.session_token description: >- Cookie de sesión Better Auth emitida al iniciar sesión en el frontend web. En producción el nombre lleva prefijo `__Secure-`. ````