> ## Documentation Index
> Fetch the complete documentation index at: https://locatebyteli.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Historial de viajes

> Obtiene los viajes del dispositivo en un rango de tiempo

## Authorization

<ParamField header="Authorization" type="string" required default="Bearer ">
  API Key. Formato: `Bearer lbt_•••`
</ParamField>

## Path Parameters

<ParamField path="id" type="uuid" required>
  ID del dispositivo
</ParamField>

## Query Parameters

<ParamField query="from" type="integer" required>
  Timestamp Unix de inicio
</ParamField>

<ParamField query="to" type="integer" required>
  Timestamp Unix de fin
</ParamField>

## Descripción

Obtiene segmentos de movimiento con inicio, fin, distancia y duración.

## Respuesta

Segmentos de viaje con inicio, fin, distancia y duración.

<ResponseExample>
  ```json 200 theme={null}
  {
    "travels": [
      {
        "start": {
          "latitude": 19.4326,
          "longitude": -99.1332,
          "timestamp": 1710750000,
          "address": "Av. Insurgentes Sur 1234, CDMX"
        },
        "end": {
          "latitude": 19.4500,
          "longitude": -99.1500,
          "timestamp": 1710753600,
          "address": "Av. Reforma 567, CDMX"
        },
        "distance": 8.5,
        "duration": 3600,
        "max_speed": 85,
        "avg_speed": 42
      },
      {
        "start": {
          "latitude": 19.4500,
          "longitude": -99.1500,
          "timestamp": 1710757200,
          "address": "Av. Reforma 567, CDMX"
        },
        "end": {
          "latitude": 19.4326,
          "longitude": -99.1332,
          "timestamp": 1710760800,
          "address": "Av. Insurgentes Sur 1234, CDMX"
        },
        "distance": 9.2,
        "duration": 3600,
        "max_speed": 90,
        "avg_speed": 46
      }
    ],
    "total_travels": 2,
    "total_distance": 17.7,
    "total_duration": 7200
  }
  ```
</ResponseExample>

## Errores

| Código | Descripción                |
| ------ | -------------------------- |
| `404`  | Dispositivo no encontrado  |
| `500`  | Error interno del servidor |