Skip to main content
GET
/
devices
/
{id}
Obtener dispositivo
curl --request GET \
  --url https://api.locatebyteli.com/devices/{id} \
  --header 'Authorization: <authorization>'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "660e8400-e29b-41d4-a716-446655440000",
  "alias": "Mi Vehículo",
  "properties": { "picture": "url", "plate": "ABC-123" },
  "serial": "123456789012",
  "imei": "123456789012345",
  "iccid": "8931440000000000000",
  "state": "stopped",
  "location": [19.4326, -99.1332],
  "connected": true,
  "connected_at": "2026-03-18T10:00:00Z",
  "disconnected_at": "2026-03-17T22:00:00Z",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2026-03-18T10:00:00Z"
}

​
Authorization

​
Authorization
string
default:"Bearer "
required
API Key. Formato: Bearer lbt_•••

​
Path Parameters

​
id
uuid
required
ID del dispositivo

​
Respuesta

​
id
uuid
ID del registro dispositivo-cuenta
​
model
uuid
ID del modelo/tipo de dispositivo
​
alias
string
Nombre asignado por el usuario
​
properties
object
Propiedades personalizadas (foto, placa, VIN, etc.)
​
serial
string
Número de serie del dispositivo
​
imei
string
IMEI del dispositivo
​
iccid
string
ICCID de la SIM asociada
​
state
string
Estado del dispositivo: off, moving, stopped, suspended, unlink, stolen, new
​
location
array
Coordenadas [latitud, longitud]
​
connected
boolean
Si el dispositivo está conectado actualmente
​
connected_at
datetime
Última fecha de conexión
​
disconnected_at
datetime
Última fecha de desconexión
​
created_at
datetime
Fecha de creación del registro
​
updated_at
datetime
Última actualización
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "660e8400-e29b-41d4-a716-446655440000",
  "alias": "Mi Vehículo",
  "properties": { "picture": "url", "plate": "ABC-123" },
  "serial": "123456789012",
  "imei": "123456789012345",
  "iccid": "8931440000000000000",
  "state": "stopped",
  "location": [19.4326, -99.1332],
  "connected": true,
  "connected_at": "2026-03-18T10:00:00Z",
  "disconnected_at": "2026-03-17T22:00:00Z",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2026-03-18T10:00:00Z"
}

​
Comportamiento

  • El usuario debe tener acceso al dispositivo a través de sus grupos
  • Si el dispositivo está en estado "moving", actualiza la ubicación en tiempo real

​
Errores

CódigoDescripción
404Dispositivo no encontrado o sin acceso
504Timeout en la consulta