Listar dispositivos
curl --request GET \
--url https://api.locatebyteli.com/devices \
--header 'Authorization: <authorization>'import requests
url = "https://api.locatebyteli.com/devices"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.locatebyteli.com/devices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.locatebyteli.com/devices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.locatebyteli.com/devices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.locatebyteli.com/devices")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.locatebyteli.com/devices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body[
{
"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"
}
]
Dispositivos
Listar dispositivos
Lista todos los dispositivos accesibles por el usuario autenticado
GET
/
devices
Listar dispositivos
curl --request GET \
--url https://api.locatebyteli.com/devices \
--header 'Authorization: <authorization>'import requests
url = "https://api.locatebyteli.com/devices"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.locatebyteli.com/devices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.locatebyteli.com/devices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.locatebyteli.com/devices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.locatebyteli.com/devices")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.locatebyteli.com/devices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body[
{
"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
string
default:"Bearer "
required
API Key. Formato:
Bearer lbt_•••Query Parameters
string[]
Filtrar por UUIDs de grupos
integer
default:"99"
Cantidad máxima de resultados
integer
default:"0"
Offset para paginación
Respuesta
Array de dispositivos con la siguiente estructura:uuid
ID del registro dispositivo-cuenta
uuid
ID del modelo/tipo de dispositivo
string
Nombre asignado por el usuario
object
Propiedades personalizadas (foto, placa, VIN, etc.)
string
Número de serie del dispositivo
string
IMEI del dispositivo
string
ICCID de la SIM asociada
string
Estado del dispositivo:
off, moving, stopped, suspended, unlink, stolen, newarray
Coordenadas
[latitud, longitud]boolean
Si el dispositivo está conectado actualmente
datetime
Última fecha de conexión
datetime
Última fecha de desconexión
datetime
Fecha de creación del registro
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 enX-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ódigo | Descripción |
|---|---|
404 | No se encontraron dispositivos |
504 | Timeout en la consulta a la BD |
⌘I