> ## 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 eventos

> Obtiene los eventos/alarmas 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>

<Note>
  También disponible en `GET /devices/{id}/events`
</Note>

## Respuesta

Array de eventos con la siguiente estructura:

<ResponseField name="alarm_code" type="string">
  Código de la alarma o evento
</ResponseField>

<ResponseField name="context" type="object">
  Datos adicionales del evento
</ResponseField>

<ResponseField name="speed" type="integer">
  Velocidad al momento del evento (km/h)
</ResponseField>

<ResponseField name="satellite" type="integer">
  Satélites GPS captados
</ResponseField>

<ResponseField name="coordinates" type="array">
  `[latitud, longitud]`
</ResponseField>

<ResponseField name="mcc" type="integer">
  Mobile Country Code
</ResponseField>

<ResponseField name="mnc" type="integer">
  Mobile Network Code
</ResponseField>

<ResponseField name="dbm" type="integer">
  Intensidad de señal celular
</ResponseField>

<ResponseField name="timestamp" type="integer">
  Timestamp Unix del evento
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "alarm_code": "SOS",
      "context": { "triggered_by": "button" },
      "speed": 60,
      "satellite": 8,
      "coordinates": [19.4326, -99.1332],
      "mcc": 334,
      "mnc": 20,
      "dbm": -75,
      "timestamp": 1710756000
    },
    {
      "alarm_code": "OVERSPEED",
      "context": { "limit": 80, "actual": 120 },
      "speed": 120,
      "satellite": 10,
      "coordinates": [19.4400, -99.1400],
      "mcc": 334,
      "mnc": 20,
      "dbm": -68,
      "timestamp": 1710757500
    }
  ]
  ```
</ResponseExample>

## Errores

| Código | Descripción               |
| ------ | ------------------------- |
| `404`  | Dispositivo no encontrado |
| `500`  | Error en la consulta      |