GET /api/devices/available — List Unclaimed Devices

Returns all active devices that have not yet been assigned to any user (user_id IS NULL). Use this endpoint to populate a device discovery UI before calling POST /api/devices/{id}/add to claim a device.

Endpoint

Field	Value
Method	GET
Path	`/api/devices/available`
Auth	Bearer token required (`Authorization: Bearer YOUR_TOKEN`)

Request

No query parameters or request body.

curl -X GET http://localhost/api/devices/available \
  -H "Authorization: Bearer YOUR_TOKEN"

Response (200 OK)

{
  "status": "success",
  "message": "Dispositivos disponibles para agregar",
  "data": [
    {
      "id": 5,
      "device_token": "abc123...",
      "name": "Dispositivo Smart Enviro",
      "mac_address": "AA:BB:CC:DD:EE:FF",
      "type": "sensor_multi",
      "is_online": false,
      "last_seen": null
    }
  ]
}

status

string

Always "success" on a 200 response.

message

string

A human-readable label confirming the query returned available devices.

data

array

Array of unclaimed, active device objects.

Show data[]

data[].id

integer

Unique device identifier. Pass this value to POST /api/devices/{id}/add to claim the device.

data[].device_token

string

The device’s 64-character authentication token. Displayed for reference; used by the ESP32 firmware.

data[].name

string

Default display name provisioned with the device (e.g. "Dispositivo Smart Enviro").

data[].mac_address

string

The hardware MAC address of the ESP32 module (e.g. "AA:BB:CC:DD:EE:FF").

data[].type

string

Device type identifier (e.g. "sensor_multi").

data[].is_online

boolean

Whether the device has communicated with the backend recently. Typically false for newly provisioned devices.

data[].last_seen

string | null

ISO 8601 timestamp of the last time the device contacted the backend (last_seen_at). null if the device has never synced.

Only active devices (is_active = true) with no owner appear in this list. Devices already assigned to other users, inactive devices, and soft-deleted devices are all excluded.

Authentication

Devices

Sensor Data

GET /api/devices/available — List Unclaimed Devices

Endpoint

Request

Response (200 OK)

Build docs developers (and LLMs) love

Authentication

Devices

Sensor Data

Documentation Index

​Endpoint

​Request

​Response (200 OK)

Build docs developers (and LLMs) love

Endpoint

Request

Response (200 OK)