Skip to main content

DeviceResource

Properties

NameTypeRequiredDescription
id_strInternal identifier of a device
uristrCanonical URI of a device
skustrDevice identification number (SKU, Stock Keeping Unit) in the format TP-ID [-AT-AC], where TP is device type (HP for RC desk phones, DV for all other devices including soft phones); ID - device model ID; AT - add-on type ID; AC - add-on count (if any). For example 'HP-56-2-2'
type_DeviceResourceTypeDevice type
namestrDevice name. Mandatory if ordering SoftPhone or OtherPhone. Optional for HardPhone. If not specified for HardPhone, then a device model is used as a device name
serialstrSerial number for HardPhone (is returned only when the phone is shipped and provisioned); endpoint ID for SoftPhone and mobile applications
statusDeviceResourceStatusDevice status
computer_namestrComputer name (for devices of SoftPhone type only)
modelModelInfoHardPhone model information
extensionExtensionInfoIntIdThis attribute can be omitted for unassigned devices
emergencyDeviceEmergencyInfoDevice emergency settings
emergency_service_addressEmergencyServiceAddressResourceAddress for emergency cases. The same emergency address is assigned to all the numbers of one device
phone_linesList[PhoneLinesInfo]Phone lines information
shippingShippingInfoShipping information, according to which devices (in case of HardPhone) or e911 stickers (in case of SoftPhone and OtherPhone) will be delivered to the customer
box_billing_idintBox billing identifier of a device. Applicable only for devices of HardPhone type. It is an alternative way to identify the device to be ordered. Either model structure, or boxBillingId must be specified
use_as_common_phoneboolSupported only for devices assigned to Limited extensions. If true, enables users to log in to this phone as a common phone.
hot_desk_deviceboolThis flag indicates whether this device is used for hot desking or not
in_company_netboolNetwork location status. true if the device is located in the configured corporate network (On-Net); false for Off-Net location. Parameter is not returned if EmergencyAddressAutoUpdate feature is not enabled for the account/user, or if device network location is not determined
siteDeviceSiteInfoSite data
last_location_report_timestrDate/time of receiving last location report in ISO 8601 format including timezone, for example *2016-03-10T18:07:52.534Z
line_poolingLinePoolingEnumPooling type of device: - Host - device with a standalone paid phone line which can be linked to soft phone client instance; - Guest - device with a linked phone line; - None - device without a phone line or with a specific line (free, BLA, etc.)
billing_statementBillingStatementInfoBilling information. Returned for device update request if prestatement query parameter is set to 'true'

DeviceResourceType

Device type

Properties

NameTypeRequiredDescription
BLAstr"BLA"
SOFTPHONEstr"SoftPhone"
OTHERPHONEstr"OtherPhone"
HARDPHONEstr"HardPhone"
WEBPHONEstr"WebPhone"
PAGINGstr"Paging"
ROOMstr"Room"
WEBRTCstr"WebRTC"

DeviceResourceStatus

Device status

Properties

NameTypeRequiredDescription
OFFLINEstr"Offline"
ONLINEstr"Online"

Build Your Own SDKs with  liblab

Build developer friendly SDKs in minutes from your APIs

Start for Free →