Skip to main content
GET
/
devices
Listar dispositivos
curl --request GET \
  --url https://api.locatebyteli.com/devices \
  --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": "moving",
    "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_•••

​
Query Parameters

​
groups
string[]
Filtrar por UUIDs de grupos
​
limit
integer
default:"99"
Cantidad máxima de resultados
​
offset
integer
default:"0"
Offset para paginación

​
Respuesta

Array de dispositivos con la siguiente estructura:
​
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": "moving",
    "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

  • Si el usuario accede vía share (X-ACT = "shared"), solo devuelve los dispositivos indicados en X-Dev
  • Si el dispositivo está en estado "moving", se obtiene la última ubicación en tiempo real
  • No se devuelven dispositivos en estado "unlink"

​
Errores

CódigoDescripción
404No se encontraron dispositivos
504Timeout en la consulta a la BD