Device

Retrieves a paginated list of devices based on the provided filters and pagination parameters. The list is sorted by updatedAt in descending order.

get/device/list

Request

  • Base URL: https://remo.nastec.eu/api
  • URL: https://remo.nastec.eu/api/device/list
  • Auth: API key in header X-Api-Key

Query parameters

pageinteger

Gets or sets the number of the current page.

itemsPerPageinteger

Gets or sets the number of items per page.

sortBystring

Gets or sets the type of sorting of the current page.

sortByDirectionstring

Gets or sets the direction of the sorting of. the current page.

groupMemberIdsstring[]

Gets or sets the list of active group member IDs for filtering. When set, filters devices to include only those owned by users in this group. Used in conjunction with group-based permissions to show devices accessible to group members.

typestring
Example:"iot", "iot32", "smartphone".

Gets or sets the device type filter to distinguish between IoT devices and smartphones.

pairedboolean

Gets or sets the pairing status filter to show only paired or unpaired devices.

ownerstring
Example:"user123", "auth0|123456789".

Gets or sets the specific owner ID to filter devices by a single user. When set, returns devices owned by this user or where this user is a collaborator.

ownersstring[]

Gets or sets the list of user IDs to filter devices where users are owners or collaborators. Supports complex permission scenarios by allowing multiple user IDs in a single filter. When combined with GroupMemberIds, uses OR logic to include devices accessible through either mechanism.

filterdUserIdsstring[]

Gets or sets the list of user IDs that match a search query. This property is populated by the controller after processing search terms and contains user IDs whose profiles match the search criteria. Used internally to filter devices by searchable user information.

connectionStatusstring
Example:"online", "offline".

Gets or sets the connection status filter to show devices based on their online/offline state. Devices are considered online if they have connected within the last 10 minutes.

stateinteger

Gets or sets the device state filter.

searchstring

Gets or sets the generic search filter value.

idsstring[]

Gets or sets the list of ids.

Response

Returns the list of devices.

idstring nullable

Gets or sets the Mongo objectId.

createdAtstring date-time nullable

Gets or sets the date and time of the entity creation.

updatedAtstring date-time nullable

Gets or sets the date and time of the entity last update.

createdBystring nullable

Gets or sets the who created the entity.

updatedBystring nullable

Gets or sets who has made the last update to the entity.

namestring nullable

Gets or sets the device name.

deviceIdstring nullable

Gets or sets the device identifier.

locationstring nullable

Gets or sets the location.

tagstring nullable

Gets or sets the tag.

notesstring nullable

Gets or sets the notes.

lastNoteIdstring nullable

Gets or sets the identifier of the most recent note.

firstConnectionstring date-time nullable

Gets or sets the first connection date.

lastConnectionstring date-time nullable

Gets or sets the last connection date.

locationChangedByUserboolean

Gets or sets a value indicating whether the location has change by the user.

gpsCoordinatesChangedByUserboolean

Gets or sets a value indicating whether the GPS coordinates have been changed by the user.

currentInverterstring nullable

Gets or sets the current inverter.

createTodoAutomaticallyboolean

Gets or sets a value indicating whether the alarms and warnings chosen in TM.Nastec.Remo.Core.Application.Dtos.Devices.DeviceResponseDto.TodoConfiguration raise a ToDo on this device.

deviceType0 | 1 | 2

Represents the type of a Device.

iotboolean

Gets a value indicating whether the device is any IOT variant (Iot or Iot32). Maintained for backward compatibility.

isIot32boolean

Gets a value indicating whether the device is IOT ESP32.

addressIsInvalidboolean

Gets or sets a value indicating whether the device address needs recalculation.

geocodingRetryCountinteger

Gets or sets the number of consecutive failed geocoding attempts.

userPermission0 | 1 | 2

Represents the possible permissions of a GroupUser.

Changes

No recorded changes to this operation across all 1 revision of this API.