Device Details

Updated on: October 9, 2025
Purpose: Retrieve detailed information about a specific Salpre Box device using its serial ID. Use this endpoint to check connection status, firmware version, and activity logs of a particular device.

---

Endpoint

GET https://ai.salpre.com/api/gateway/v1/salprebox/device/{device_serial_id}

Example:

GET https://ai.salpre.com/api/gateway/v1/salprebox/device/SALPRE-BOX-42A8F9

Authentication:
All requests require your Account Secret Key.

account-secret-key: YOUR_API_KEY

Keep your Account Secret Key private. Do not expose it in frontend or client-side code.

---

URL parameters

Name	Type	Required	Description
device_serial_id	string	Yes	The serial ID of the device to retrieve. Example: SALPRE-BOX-42A8F9.

---

Code samples

cURL (Bash)

curl --location --request GET 'https://ai.salpre.com/api/gateway/v1/salprebox/device/{{device_serial_id}}' \
--header 'account-secret-key: YOUR_API_KEY'

JavaScript (Fetch)

const myHeaders = new Headers();
myHeaders.append("account-secret-key", "YOUR_API_KEY");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://ai.salpre.com/api/gateway/v1/salprebox/device/{{device_serial_id}}", requestOptions)
  .then(response => response.json())
  .then(result => console.log(result))
  .catch(error => console.log("error", error));

---

Example response

{
  "status": "success",
  "data": {
    "id": 42,
    "serial_no": "SALPRE-BOX-42A8F9",
    "device_name": "Main Office Box",
    "connected": true,
    "firmware_version": "1.2.5",
    "battery_level": 92,
    "signal_strength": -67,
    "last_seen": "2025-10-09T13:21:15Z",
    "registered_at": "2025-09-20T08:14:03Z",
    "location": "Izmir, Türkiye",
    "ip_address": "212.28.178.248"
  }
}

---

Error responses

Missing or invalid authentication key

{
  "status": "error",
  "message": "Unauthorized. Missing or invalid account-secret-key"
}

Device not found

{
  "status": "error",
  "message": "Device not found. Please verify the device_serial_id."
}

---

Notes & best practices

• Use this endpoint to verify connection status before making a call.
• If connected is false, ensure the device is powered and Bluetooth/Wi-Fi is active.
• Firmware version info helps you check for available updates.
• signal_strength is in dBm — values closer to 0 mean stronger signal.
• For multiple devices, use List Devices first, then fetch details for specific serials.