GetDefaultDeviceGroupInformation

Returns information about the Default device group for the specified account. The Default device group contains all devices in the account that are not part of other device groups. (Each device can be in only one device group.)

Request Parameters

Parameter Type Description
AccountName
required
string The name of the Verizon billing account for which you want the default device group information. An account name is usually numeric, and must include any leading zeros.
LargestDeviceIdSeen
optional
long

(Output buffering parameter) Only return information about devices that have an ID greater than this value. Each successful response will include a LargestDeviceIdSeen value.

  • For the first request, leave this element empty to retrieve the devices with the smallest IDs.
  • Check the IsComplete value in the response.
  • If it's "true" then you have received the complete list of devices.
  • If IsComplete is "false," send another request, putting the returned value of LargestDeviceIdSeen into this field. Continue sending requests with the latest LargestDeviceIdSeen value until IsComplete is "true." This ensures that all devices are retrieved exactly once, with no gaps or overlaps in devices returned by multiple calls to the API.

Response Parameters

Parameter Type Description
GroupName string The name of the device group.
GroupDescription string The description of the device group.
Devices DeviceIdentifierCollection The list of devices that belong to the default device group.
DeviceIdentifiers DeviceIdentifier One or more identifiers for the device.
Kind string The type of the device identifier. Valid types of identifiers are:
  • ESN (decimal)
  • ICCID (up to 20 digits)
  • IMEI (up to 15 digits)
  • MDN
  • MEID (hexadecimal)
  • MIN
  • MSISDN
Identifier string The value of the device identifier.
IsComplete boolean Indicates whether all devices in the group have been returned. If IsComplete is false, call this API again and put the LargestDeviceIdSeen value in the request, which will return the next set of devices with sequentially larger device IDs.
LargestDeviceIdSeen long The largest device ID included in the response.
ExtendedAttributes ExtendedAttributesObj Not used; null

Example SOAP Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:v2="http://nphase.com/unifiedwebservice/v2"
  xmlns:nph="http://schemas.datacontract.org/2004/07/NPhase.UnifiedWebService.APIs.v2.Contract.DeviceGroupService">
  <soapenv:Header>
    <v2:token>91bd36d3-a063-4600-928b-bb57eeccb9ac</v2:token>
  </soapenv:Header>
  <soapenv:Body>
    <v2:GetDefaultDeviceGroupInformation>
      <v2:Input>
        <nph:AccountName>Account Name</nph:AccountName>
      </v2:Input>
    </v2:GetDefaultDeviceGroupInformation>
  </soapenv:Body>
</soapenv:Envelope>

Example SOAP Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <GetDefaultDeviceGroupInformationResponse xmlns="http://nphase.com/unifiedwebservice/v2">
      <Output xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:a="http://schemas.datacontract.org/2004/07/NPhase.UnifiedWebService.APIs.v2.Contract.DeviceGroupService">
        <a:GroupName>Default: All Trucks</a:GroupName>
        <a:GroupDescription>Default group used for all truck monitors</a:GroupDescription>
        <a:Devices xmlns:b="http://schemas.datacontract.org/2004/07/NPhase.UnifiedWebService.APIs.v2.Contract.Common">
          <a:DeviceIdentifierCollection>
            <a:DeviceIdentifiers>
              <a:DeviceIdentifier>
                <a:Kind>ESN</a:Kind>
                <a:Identifier>09102885873</a:Identifier>
              </a:DeviceIdentifier>
            </a:DeviceIdentifiers>
          </a:DeviceIdentifierCollection>
          <a:DeviceIdentifierCollection>
            <a:DeviceIdentifiers>
              <a:DeviceIdentifier>
                <a:Kind>ESN</a:Kind>
                <a:Identifier>09611822299</a:Identifier>
              </a:DeviceIdentifier>
            </a:DeviceIdentifiers>
          </a:DeviceIdentifierCollection>
        </a:Devices>
        <a:IsComplete>true</a:IsComplete>
        <a:LargestDeviceIdSeeen>2071923664</a:LargestDeviceIdSeeen>
        <a:ExtendedAttributes i:nil="true" xmlns:b="http://schemas.datacontract.org/2004/007/NPhase.UnifiedWebService.APIs.v2.Contract.Common"/>
      </Output>
    </GetDefaultDeviceGroupInformationResponse>
  </soapenv:Body>
</soapenv:Envelope>

Request Schema Diagram

Response Schema Diagram