msdyn_iotdevice EntityType

Represents a connected device that can be registered with an IoT provider.

Entity Set Path
[organization URI]/api/data/v9.0/msdyn_iotdevices
Base Type
Display Name
IoT Device
Primary Key
Primary Key Attribute
Operations Supported


Properties represent fields of data stored in the entity.Some properties are read-only.

Name Type Details
createdon Edm.DateTimeOffset

Date and time when the record was created.

Display Name: Created On

Read Only
importsequencenumber Edm.Int32

Sequence number of the import that created this record.

Display Name: Import Sequence Number

modifiedon Edm.DateTimeOffset

Date and time when the record was modified.

Display Name: Modified On

Read Only
msdyn_connectionstate Edm.Boolean

The connection status of the device (Disconnected or Connected)

Display Name: Connection State

Default Options
Value Label
1 Connected
0 Disconnected
msdyn_deviceid Edm.String

Device ID used to register with the IoT provider.

Display Name: Device ID

msdyn_devicereportedproperties Edm.String

Reported Properties data for Device

Display Name: Device Reported Properties

msdyn_devicesettings Edm.String

The editable properties for a device.

Display Name: Device Settings

msdyn_iotdeviceid Edm.Guid

Unique identifier for entity instances

Display Name: IoT Device

msdyn_issimulated Edm.Int32

Select “Yes” if this device is simulated for testing and development purposes. Select “No” if this is a real device.​

Display Name: Simulated

Default Options
Value Label
192350000 Yes
192350001 No
msdyn_lastactivitytime Edm.DateTimeOffset

The last activity time of the device

Display Name: Last Activity Time

msdyn_lastcommandsenttime Edm.DateTimeOffset

Display Name: [Deprecated] Last Command Sent Time

msdyn_name Edm.String

The name of the custom entity.

Display Name: Name

msdyn_registrationmessage Edm.String

A message field that explains the IoT Registration Status.

Display Name: Registration Message

msdyn_registrationstatus Edm.Int32

A status field that denotes whether the device is registered with the IoT provider.

Display Name: Registration Status

Default Options
Value Label
192350000 Unknown
192350001 Unregistered
192350002 In Progress
192350003 Registered
192350004 Error
msdyn_tags Edm.String

Identifying Tags for the Device

Display Name: Device Tags

msdyn_timezone Edm.Int32

The device's time zone.

Display Name: Time Zone

overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

statecode Edm.Int32

Status of the IoT Device

Display Name: Status

Default Options
Value Label
0 Active
1 Inactive
statuscode Edm.Int32

Reason for the status of the IoT Device

Display Name: Status Reason

Default Options
Value Label
1 Active
2 Inactive
timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

utcconversiontimezonecode Edm.Int32

Time zone code that was in use when the record was created.

Display Name: UTC Conversion Time Zone Code

versionnumber Edm.Int64

Version Number

Display Name: Version Number

Read Only

Lookup Properties

Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Retrieve data about lookup properties.

Name Single-valued navigation property Description
_createdby_value createdby

Unique identifier of the user who created the record.

_createdonbehalfby_value createdonbehalfby

Unique identifier of the delegate user who created the record.

_modifiedby_value modifiedby

Unique identifier of the user who modified the record.

_modifiedonbehalfby_value modifiedonbehalfby

Unique identifier of the delegate user who modified the record.

_msdyn_account_value msdyn_Account

Parent customer of this device

_msdyn_category_value msdyn_Category

The device category that this IoT device belongs to.

_msdyn_iotproviderinstance_value msdyn_IoTProviderInstance

The IoT Provider Instance to which this device belongs.

_msdyn_lastcommandsent_value msdyn_LastCommandSent
_ownerid_value ownerid

Owner Id

_owningbusinessunit_value owningbusinessunit

Unique identifier for the business unit that owns the record

_owningteam_value owningteam

Unique identifier for the team that owns the record.

_owninguser_value owninguser

Unique identifier for the user that owns the record.

Single-valued navigation properties

Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.

Name Type Partner
createdby systemuser lk_msdyn_iotdevice_createdby
createdonbehalfby systemuser lk_msdyn_iotdevice_createdonbehalfby
modifiedby systemuser lk_msdyn_iotdevice_modifiedby
modifiedonbehalfby systemuser lk_msdyn_iotdevice_modifiedonbehalfby
msdyn_Account account msdyn_account_msdyn_iotdevice_Account
msdyn_Category msdyn_iotdevicecategory msdyn_msdyn_iotdevicecategory_msdyn_iotdevice_Category
msdyn_LastCommandSent msdyn_iotdevicecommand msdyn_msdyn_iotdevicecommand_msdyn_iotdevice_LastCommandSent
ownerid principal owner_msdyn_iotdevice
owningbusinessunit businessunit business_unit_msdyn_iotdevice
owningteam team team_msdyn_iotdevice
owninguser systemuser user_msdyn_iotdevice

Collection-valued navigation properties

Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.

Name Type Partner
msdyn_iotdevice_Annotations annotation objectid_msdyn_iotdevice
msdyn_iotdevice_AsyncOperations asyncoperation regardingobjectid_msdyn_iotdevice
msdyn_iotdevice_BulkDeleteFailures bulkdeletefailure regardingobjectid_msdyn_iotdevice
msdyn_iotdevice_connections1 connection record1id_msdyn_iotdevice
msdyn_iotdevice_connections2 connection record2id_msdyn_iotdevice
msdyn_iotdevice_DuplicateBaseRecord duplicaterecord baserecordid_msdyn_iotdevice
msdyn_iotdevice_DuplicateMatchingRecord duplicaterecord duplicaterecordid_msdyn_iotdevice
msdyn_iotdevice_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_msdyn_iotdevice
msdyn_iotdevice_PrincipalObjectAttributeAccesses principalobjectattributeaccess objectid_msdyn_iotdevice
msdyn_iotdevice_ProcessSession processsession regardingobjectid_msdyn_iotdevice
msdyn_iotdevice_SyncErrors syncerror regardingobjectid_msdyn_iotdevice
msdyn_msdyn_iotdevice_msdyn_iotalert_Device msdyn_iotalert msdyn_Device
msdyn_msdyn_iotdevice_msdyn_iotdevicecommand_Device msdyn_iotdevicecommand msdyn_Device
msdyn_msdyn_iotdevice_msdyn_iotdeviceregistrationhistory_Device msdyn_iotdeviceregistrationhistory msdyn_Device


The following operations can be used with the msdyn_iotdevice entity type.

Name Binding
GrantAccess Not Bound
IsValidStateTransition Not Bound
ModifyAccess Not Bound
RetrievePrincipalAccess Not Bound
RetrieveSharedPrincipalsAndAccess Not Bound
RevokeAccess Not Bound


The following solutions include the msdyn_iotdevice entity type.

Name Description
IoT Connector for Microsoft Dynamics 365 Enables IoT scenarios in Dynamics 365.

See also