ChangeDeviceState - Activate

A list of the devices for which you want to activate service, specified by device identifier. Do not pass DeviceGroupName or DeviceCustomFieldFilter if you use this parameter.

You can use GetDeviceList to get a list of all devices in the account.

For each device in DeviceList, use this structure of nested parameters:

<DeviceIdentifierCollection>
  <DeviceIndentifiers>
    <DeviceIdentifier>
      <Kind></Kind>
      <Identifier></Identifier>
    </DeviceIdentifier>
  </DeviceIndentifiers>
  <IpAddress></IpAddress>
</DeviceIdentifierCollection>

• ICCID (up to 20 digits)
• IMEI (up to 16 digits)
• MDN
• MSISDN

For 4G devices, you must specify both the IMEI and the ICCID within separate DeviceIdentifier elements, in that order.

The IP address to assign to the device (in the following format: 1-255.0-255.0-255.0-255).

The name of a billing account, which can serve one of two purposes:

• This parameter is required to activate new devices that have not already been added to the account. You must also include the DeviceList parameter to identify the devices.
• If you are passing DeviceGroupName to activate all devices in a device group that have already been added to an account, and you have access to multiple accounts, this parameter is required since the same device group name can exist in multiple accounts.

An account name is usually numeric, and must include any leading zeros.

Allowed characters in custom field values

• Alphanumeric characters
• / (forward slash)
• SPACE
• @ (at sign)
• . (period)
• , (comma)
• : (colon)
• - (hyphen)
• _ (underscore)
• ( (open parenthesis)
• ) (close parenthesis)
• [ (open bracket)
• ] (close bracket)
• # (number sign or hash)

The service plan code that you want to assign to all specified devices. Set this parameter to one of the Code values returned by GetServicePlanList in the Account Service.

Verizon Wireless provides service plan codes at the time of on-boarding and subsequently whenever there are any changes to the service plan.

NOTE: Any devices in the request that are not supported by the service plan will not activate.

The Zip code of the location where the line of service will primarily be used, or a Zip code that you have been told to use with these devices. For accounts that are configured for geographic numbering, this is the ZIP code from which the MDN will be derived.

NOTE: If you include LeadId in an activation request, you should set the MdnZipCode value to match the AddressZipCode value defined for the lead. You can use GetLeadInformation to get a list of all leads, which includes the address information.

Allowed characters in custom field values:

• Alphanumeric characters
• / (forward slash)
• SPACE
• @ (at sign)
• . (period)
• , (comma)
• : (colon)
• - (hyphen)
• _ (underscore)
• ( (open parenthesis)
• ) (close parenthesis)
• [ (open bracket)
• ] (close bracket)
• # (number sign or hash)

The ID of a "Qualified" or "Closed - Won" VPP customer lead, which is used with other values to determine MDN assignment, taxation, and compensation. Use GetLeadInformation to get a list of valid Lead IDs.

LeadId is not allowed for non-VPP activations.

NOTE:If you include LeadId in an activation request, you should set the MdnZipCode value to match the AddressZipCode value defined for the lead. You can use GetLeadInformation to get a list of all leads, which includes the address information.

For devices with static IP addresses on the public network, this specifies whether the devices have general access to the Internet. Valid values are "restricted" or "unrestricted".

• Unrestricted = The devices will have full access to the Internet.
• Restricted = The devices will have access to any content provided by Verizon Wireless but will be restricted from access to the Internet.

If left blank, the devices will get the default value set for the account. Public network devices with dynamic IP addresses are always unrestricted.

The customer name and the address of the device's primary place of use. Leave these fields empty to use the account profile address as the primary place of use. These values will be applied to all devices in the activation request.

If the account is enabled for non-geographic MDNs and the device supports it, the PrimaryPlaceOfUse address will also be used to derive the MDN for the device.

The Primary Place of Use location may affect taxation or have other legal implications. You may want to speak with legal and/or financial advisers before entering values for these fields.

NOTE: PrimaryPlaceOfUse cannot be used with LeadId. VPP partners should enter a LeadId value for a customer lead, and the AddressZipCode in the lead record will be used for taxation. VPP partners can use PrimaryPlaceOfUse fields without a LeadId to associate customer-specific data with devices.

A single letter to indicate the customer phone type:

• M = Mobile
• H = Home
• F = Fax
• W = Work/Business
• P = Pager

The Stock Keeping Unit (SKU) number of a 4G device type with an embedded SIM. Can be used with ICCID device identifiers in lieu of an IMEI when activating 4G devices. The SkuNumber will be used with all devices in the request, so all devices must be of the same type.

NOTE:If you use SKU-based activations, you must perform SIM OTA prior to any maintenance provisioning transactions (suspend, reconnect, rate plan change, feature change, etc.).

NOTE:Only 4G devices with embedded SIMs can be activated by SKU at this time.

A unique string that associates the request with the results that are sent via a callback service.

The ThingSpace Platform will send a separate callback message for each device that matched the request criteria, indicating whether the operation succeeded for that device and containing any requested information. All of the callback messages will have the same RequestId.

A separate callback message is sent for each device that matched the request criteria, indicating whether the operation succeeded for that device. All of the callback messages will have the same RequestId.

• ESN (decimal)
• ICCID (up to 20 digits)
• IMEI (up to 16 digits)
• MDN
• MEID (hexadecimal)
• MIN
• MSISDN

• ESN (decimal)
• ICCID (up to 20 digits)
• IMEI (up to 16 digits)
• MDN
• MEID (hexadecimal)
• MIN
• MSISDN