Skip to main content
GET
/
devices
curl "https://api.bota.dev/v1/devices?limit=10" \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "dev_abc123",
      "serial_number": "SN-2025-001234",
      "device_type": "bota_pin_v1",
      "firmware_version": "1.2.0",
      "status": "bound",
      "end_user_id": "eu_xyz789",
      "metadata": null,
      "created_at": "2025-01-15T10:30:00Z",
      "bound_at": "2025-01-15T11:00:00Z"
    },
    {
      "id": "dev_def456",
      "serial_number": "SN-2025-005678",
      "device_type": "bota_pin_v1",
      "firmware_version": "1.1.0",
      "status": "unbound",
      "end_user_id": null,
      "metadata": null,
      "created_at": "2025-01-14T09:00:00Z",
      "bound_at": null
    }
  ],
  "has_more": false
}
​
limit
integer
default:"25"
Maximum number of items to return (1-100).
​
offset
integer
default:"0"
Number of items to skip for pagination.
​
end_user_id
string
Filter devices by bound end user.
curl "https://api.bota.dev/v1/devices?limit=10" \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "dev_abc123",
      "serial_number": "SN-2025-001234",
      "device_type": "bota_pin_v1",
      "firmware_version": "1.2.0",
      "status": "bound",
      "end_user_id": "eu_xyz789",
      "metadata": null,
      "created_at": "2025-01-15T10:30:00Z",
      "bound_at": "2025-01-15T11:00:00Z"
    },
    {
      "id": "dev_def456",
      "serial_number": "SN-2025-005678",
      "device_type": "bota_pin_v1",
      "firmware_version": "1.1.0",
      "status": "unbound",
      "end_user_id": null,
      "metadata": null,
      "created_at": "2025-01-14T09:00:00Z",
      "bound_at": null
    }
  ],
  "has_more": false
}