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

# Datos de telemetría

> Obtiene los últimos datos de telemetría del dispositivo

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

## Respuesta

<ResponseField name="state" type="string">
  Estado actual (`moving`, `stopped`, etc.)
</ResponseField>

<ResponseField name="type" type="string">
  Tipo de dato (`state`, `alarm`, etc.)
</ResponseField>

<ResponseField name="connected" type="boolean">
  Si está conectado
</ResponseField>

<ResponseField name="alarm_code" type="string">
  Código de alarma (si aplica)
</ResponseField>

<ResponseField name="alarm_data" type="string">
  Datos adicionales de la alarma
</ResponseField>

<ResponseField name="gps" type="object">
  Datos GPS

  <Expandable title="Propiedades GPS">
    <ResponseField name="hdop" type="float">
      Dilución horizontal de precisión GPS
    </ResponseField>

    <ResponseField name="speed" type="integer">
      Velocidad en km/h
    </ResponseField>

    <ResponseField name="valid" type="boolean">
      Si la lectura GPS es válida
    </ResponseField>

    <ResponseField name="course" type="integer">
      Dirección en grados (0-360)
    </ResponseField>

    <ResponseField name="antenna" type="boolean">
      Estado de la antena GPS
    </ResponseField>

    <ResponseField name="altitude" type="integer">
      Altitud en metros
    </ResponseField>

    <ResponseField name="latitude" type="float">
      Latitud
    </ResponseField>

    <ResponseField name="longitude" type="float">
      Longitud
    </ResponseField>

    <ResponseField name="satellite" type="integer">
      Cantidad de satélites captados
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="gsm" type="object">
  Datos de red celular

  <Expandable title="Propiedades GSM">
    <ResponseField name="cid" type="integer">
      Cell ID de la torre celular
    </ResponseField>

    <ResponseField name="lac" type="integer">
      Location Area Code
    </ResponseField>

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

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

<ResponseField name="status" type="object">
  Estado del dispositivo

  <Expandable title="Propiedades de estado">
    <ResponseField name="armed" type="boolean">
      Si el dispositivo está armado
    </ResponseField>

    <ResponseField name="external_power" type="boolean">
      Si tiene alimentación externa
    </ResponseField>

    <ResponseField name="authentication" type="boolean">
      Si pasó autenticación
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="voltages" type="object">
  Voltajes

  <Expandable title="Propiedades de voltajes">
    <ResponseField name="external" type="float">
      Voltaje de fuente externa
    </ResponseField>

    <ResponseField name="internal" type="float">
      Voltaje de batería interna
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="integer">
  Timestamp Unix del dato
</ResponseField>

<ResponseField name="generated_at" type="datetime">
  Fecha de generación del dato
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "state": "moving",
    "type": "state",
    "connected": true,
    "alarm_code": null,
    "alarm_data": null,
    "gps": {
      "hdop": 1.2,
      "speed": 65,
      "valid": true,
      "course": 180,
      "antenna": true,
      "altitude": 2250,
      "latitude": 19.4326,
      "longitude": -99.1332,
      "satellite": 8
    },
    "gsm": {
      "cid": 12345,
      "lac": 6789,
      "mcc": 334,
      "mnc": 20
    },
    "status": {
      "armed": false,
      "external_power": true,
      "authentication": true
    },
    "voltages": {
      "external": 12.8,
      "internal": 4.1
    },
    "created_at": 1710756000,
    "generated_at": "2026-03-18T10:00:00Z"
  }
  ```
</ResponseExample>

## Errores

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