This page lists all error codes and error messages for the asynchronous callback API responses.
All error messages are returned as SOAP faults. The <faultcode>
is composed of an M2M service name,
a period, and one of the error codes listed in the tables on this page. For example:
UnifiedWebService.REQUEST_FAILED.AccountNotFound
DeviceService.INPUT_INVALID.CustomField.InvalidName
The error messages in the tables are returned as the <faultstring>
in a SOAP fault.
The best practice is to write your code to look for the error code values, not the service names or error messages.
To see the comprehensive list of error codes and error messages for the synchronous API responses, see Synchronous Errors.
These errors are typically caught when a request is initially received and parsed, and the error messages are returned synchronously. The error messages can also be returned in callback messages for errors in bulk requests.
Error Code | Error Message | Occurs When | Resolution |
---|---|---|---|
INPUT_INVALID.Device.Account.Invalid | The device was not a part of the account specified. | The device identifier in the request did not match any devices in the account. | Verify the account name and device identifier and retry the request. |
INPUT_INVALID.Device.Identifier.Invalid | The device's {device identifier kind} was not in a valid format. | The value of the Identifier element within a DeviceIdentifier element was not in the format required by the Kind element. | he Identifier element to a value that is in the format required by the Kind element, and then resend the request. |
INPUT_INVALID.Device.Kind.Invalid | The device kind was not recognized as a valid device kind. | The "Kind" field for DeviceIdentifer did not contain a recognized value. | Retry the request with "Kind" set to one of the valid values. |
INPUT_INVALID.DeviceGroup.Account.Invalid | The device group was not a part of the account specified. | The device group given in the request does not exist in the account. | Verify the account name and device group name, and then retry the request. |
INPUT_INVALID.DeviceNotFound | Specified device identifier was not found. | The device identifier in the request did not match any devices in the account. | Verify the device identifier and retry the request. |
INPUT_INVALID.InvalidDevice | Could not find the device "{device ID}" | The device identifier in the request did not match any devices in the account. | Verify the device identifier and retry the request. |
INPUT_INVALID.NullDeviceIdentifier | No device identifier specified for this request. | An Identifier child element within a DeviceIdentifier element did not have a value. | Set the Identifier element to a value that is in the format required by the Kind element, and then resend the request. |
INPUT_INVALID.NullDeviceInformation | No device information specified for this request. | The request did not contain a device list or other device identifiers. | Verify that the request contains complete device identifiers, and then retry the request. |
INPUT_INVALID.NullDeviceKind | No device kind specified for this request. | The "Kind" field for DeviceIdentifer was empty. | Retry the request with "Kind" set to one of the valid values. |
REQUEST_FAILED.NoDevicesInGroup | There are no devices for the group. | The device group given in the request exists, but does not have any devices. | Verify that you are using the right device group name, or add devices to the group. |
REQUEST_FAILED.UnexpectedError | Unexpected error occurred. Could not complete request. | The request was missing required elements, had invalid parameter values, or an unknown problem occurred. | Verify all required and optional field values and then retry the request. If you receive this error a second time, contact Customer Support at 800.922.0204 for assistance. |
Error Code | Error Message | Occurs When | Resolution |
---|---|---|---|
REQUEST_FAILED.Device_Already_Active | Device {deviceId} or ICCID {iccId} is already active on another MTN | ||
INPUT_INVALID.Activate.NullServicePlan | A service plan is required when activating this device. | The request did not specify a value for the ServicePlan field. | Set the ServicePlan field to the service plan code that you want to assign to all specified devices, and then resend the request. |
INPUT_INVALID.Activate.VodafoneServicePlan | A service plan may not be specified when activating a Vodafone device. | The ChangeDeviceState request to activate a Vodafone device contained a ServicePlan value. | Do not set a ServicePlan value when activating a Vodafone device. |
INPUT_INVALID.CarrierPoolNameOnNonB2BCarrier | Carrier IP pool name can only be provided for B2B carriers. | The request contained a value for CarrierIpPoolName. | The CarrierIpPoolName parameter is only used with B2B carriers. Do not include it for other carriers. |
INPUT_INVALID.Device.EtfWaiver.NotDefined | ETF waiver is required for deactivating retail devices. | The request did not include a value for EtfWaiver. | Set EtfWaiver to true (you want to use an ETF waiver on this deactivation) or false (you do not want to use a waiver). |
INPUT_INVALID.Device.InvalidChangeDeviceIdentifierKind | Cannot provide IMSI when IMEI and ICCID are provided, or vice versa, for activation request. | The request included incompatible device identifiers. | In the list of device identifiers in the DeviceIdentifierCollection element, provide either an IMSI or an IMEI and ICCID, but not all three. |
INPUT_INVALID.Device.OnlyOneProvidedOfImeiOrIccid | Cannot provide IMEI without ICCID, or vice versa, for activation request. | An Activate request for a 4G device did not contain both the IMEI and ICCID identifiers. | Resend the request with both the IMEI and the ICCID of the device, in that order. |
INPUT_INVALID.Device.ReasonCode.NotDefined | ReasonCode is required for deactivating retail devices. | The Deactivate request was for a retail device that requires a ReasonCode for the deactivation. | Set a value for ReasonCode and retry the request. |
INPUT_INVALID.DeviceIdentifierNullInCollection | A device identifier in the collection cannot be null. | An Identifier child element within a DeviceIdentifier element did not have a value. | Set the Identifier element to a value that is in the format required by the Kind element, and then resend the request. |
INPUT_INVALID.DuplicateDeviceKindInCollection | Two device identifiers in the collection cannot have the same kind. | Two device identifiers in a DeviceIdentifierCollection had the same value for Kind. | Most requests only need one device identifier per device. If you need to provide two, they must be different Kinds. |
INPUT_INVALID.InvalidAccountName | Account Name is not valid for this request. | The request did not included an account name. | Specify an account name and retry the request. |
INPUT_INVALID.MdnNpaNxx.Invalid | The Mdn Npa-Nxx cannot be provided for the carrier of this device. | The request included an MdnNpaNxx value, which is not allowed the service carrier. | Retry the request without the MdnNpaNxx value. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Cost Center Code cannot be blank. | The ChangeDeviceCostCenter API requires a value in the CostCenterCode parameter or the RemoveCostCenterCode parameter. The request did not contain either of those. | Retry the request with a valid CostCenterCode value. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Cost Center Code cannot be greater than 36 characters. | The CostCenterCode value was too long. | Use a shorter code (string) and retry the request. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Device is already active. | An Activate request was sent for a device that is already active. | Check the current device state. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Device is already in a Deactive state. | A Deactivate request was sent for a device that is already deactive. | Check the current device state. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Device is not listed with the Verizon Wireless network. Please contact Support. | The device is not listed in the Device Management Database. | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_ FAILED.The device ICCID is not compatible with the SKU provided. Verify the ICCID and SKU and retry the request. | The ICCID provided is not compatible with the device type indicated by the SkuNumber. For example, the device type may indicate an embedded SIM but the ICCID is not for an embedded SIM. | Verify the ICCID and the SkuNumber and then try the request again. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_ FAILED.Device SKU is not a valid Verizon SKU. Verify the SKU and retry the request. | The SkuNumber provided does not match any SKU-enabled devices in the Verizon Device Management Database. | Verify and correct the SkuNumber and then try the request again. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_ FAILED.Device state is not compatible with requested action. | A ChangeDeviceState request was sent for a device that is not valid based on the device's current state. | Check the device's current state and the allowed actions for that state. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED. Error in getting available ETF waivers count for Customer Profile. Please try again. | There was a problem verifying the ETF waivers available for the account. | Wait a little while and retry the request. Contact support of it continues. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.IMEI is already paired with another ICCID. Please contact Support. | The IMEI in the request already has a SIM assigned. | Use GetDeviceInformation to find the IMEI and see what ICCID is assigned to it. You may need to contact support to correct the problem. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.IP pool not currently set up. Please contact Support to have this issue fixed. | Pool not set up in ETNI, or the pool has run out of IP addresses. | ETNI Pool setup issue. Contact Support. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED. The customer address cannot be validated. Please verify the address entered for PrimaryPlaceOfUse or the address associated with the customer LeadId, and then resend the request. To change a customer lead address, contact customer support referencing the Lead ID in the Partner Resource Management tool. | The address associated with the LeadId or entered in the PrimaryPlaceOfUse fields is invalid according to the USPS. | Verify the address and try the request again. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED. MDN does not belong to Customer Profile. Please contact Support. | The device identifier in the request did not match any devices in the account. | Verify the device identifier and account name and then retry the request. If they are in the same account as requested in the customer request, contact Support. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.MDN is not available for the provided zip code or NPA/NXX. Please contact Support. | There are no MDNs available for the given NPA-NXX, or the NPA-NXX is not valid. | Verify the MdnNpaNxx value. Contact support if the value is correct and you received this message. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.MDN not found. Please verify that MDN is correct. | The MDN was not found in a back-end system. | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.No IP addresses are available for the PublicIpRestriction type. Please contact your Verizon Account Manager for assistance. | No reserved IP addresses are available for the requested PublicIPRestriction type (static or dynamic). | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Selected service plan not compatible with device. Please select a plan that supports device. | The service plan specified in the activation request cannot be used with the specified device. | Select a compatible service plan and retry the request. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.SIM is already paired with another MSISDN. Please contact Support. | The ICCID in the request is already assigned to a phone number. | Use GetDeviceInformation to find the ICCID and see what number is assigned to it. You may need to contact support to correct the problem. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Specified service plan not recognized. Please contact Support. | The specified service plan does not exist in a back-end system. | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED. The address in the request cannot be validated. Please verify and correct the address associated with the LeadId or included in the PrimaryPlaceOfUse parameters. Addresses for leads can be changed in the Partner Resource Management tool. | The address associated with the LeadId or entered in the PrimaryPlaceOfUse fields is invalid according to the USPS. | Verify the address and try the request again. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED. Device is not valid | The device identifier is not valid, or the device does not support the requested operation. | Verify the device identifier and retry the request. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.There is already a pending order for this device. No additional actions can be performed until this order is completed. | Existing pending order blocking any new activity on the MTN | There is already a pending order submitted for this. Check in portal to view order status. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED. Your device is not currently listed as an approved device for the Verizon Wireless network. Please contact your device vendor. | The device is not listed in the Device Management Database. | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_FAILED.CarrierRequestUnsuccessful | Your (action) request was unsuccessful. Please review your request with your Company Administrator to see whether it can be administered via Verizon Enterprise Center or My Business. | There are several scenarios that can produce this error, often involving back-end systems. | This error can sometimes be resolved by just retrying the request. If you continue to get this error in the response, contact Customer Support at 1-800-525-0481 for assistance. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Activation of this device is no longer supported | The activation request was for a 3G device. | 3G devices can no longer be activated on the Verizon Wireless network. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Device is not E911 compliant | The device in the activation request does not meet E911 requirements. | Devices that can carry voice must be E911 compliant to activate them on the network. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.ICCID {iccId} not provided or is invalid | The request did not contain a valid ICCID. | Verify that the request contains a valid ICCID and retry the request. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.SIM {iccId} is already active | You sent an activation request for a SIM that is already active. | Best practice is to use GetDeviceInformation to check a device's state before sending an activation request. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Invalid Service Plan | The service plan specified in the request does not exist in the specified account. | Verify the account name and service plan name, and retry the request. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Device is not listed with the Verizon Wireless network. Please contact Support. | The device was not found in a back-end system. | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_FAILED.CarrierRequestUnsuccessful | REQUEST_FAILED.Invalid pool group provided or insufficient IP inventory in the pool | The specified IP pool does not exist in the account or does not have any available IP addresses. | Verify the name of the IP pool group and add more IP addresses, if necessary. |
REQUEST_FAILED.DefaultIpPoolNotDefined | Default IP Pool is not defined for app | There is a problem with the IP pool defined for the carrier. | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_FAILED.Device.NoAccess | The contact does not have access to the device. | The web services username that you signed in with is not associated with the device specified in the request. | Verify the account name and device identifier and then retry the request. |
REQUEST_FAILED.DeviceAlreadyActive | REQUEST_FAILED. Device is already active | You sent an activation request for a device that is already active. | Best practice is to use GetDeviceInformation to check a device's state before sending an activation request. |
REQUEST_FAILED.Max.Daily.Limit | REQUEST_FAILED. Maximum daily Suspend/Reconnect limit reached for MDN. | The specified device has already had 25 provisioning changes today, which is the maximum allowed. | Retry the request tomorrow. |
REQUEST_FAILED.MdnAlreadyAssociated | Invalid MDN. The provided MDN is already associated with another device | Contact Customer Support at 800.922.0204 for assistance. | |
REQUEST_FAILED.NoEtfWaiversAvailable | REQUEST FAILED. No ETF waivers currently available for use with this account. Please contact your Verizon Account Manager for more details about your ETF waiver status | The account does not have any ETF waivers available to apply to the deactivation request. | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_FAILED.PendingStatusChange | Can not update the device in devicemanager. msg=Device status changes from pending to pending statuses is not allowed | You sent a second ChangeDeviceState request for a device before the first request had completed. | Use GetDeviceInformation to check the state of a device before sending a ChangeDeviceState request. |
REQUEST_FAILED.RatePlanNotFound | No Service Plan was found matching the code {service plan code}. | The service plan specified in the request does not exist in the specified account. | Verify the account name and service plan name, and retry the request. |
REQUEST_FAILED.UnsupportedOperationException | Unsupported Operation Exception | An unknown error occurred. | Contact Customer Support at 800.922.0204 for assistance. |
REQUEST_ONHOLD.DeviceActivationOnHold | REQUEST_ONHOLD. Credit request is pending approval for this order | You attempted to activate service for a device, but the credit request for your account has not been approved yet. | Wait until you receive credit approval before activating service. The maximum time for a credit hold is 7 days. |
REQUEST_CANCELLED.DeviceActivationCancelled | REQUEST_CANCELLED. Credit request has been cancelled for this order | The credit request for your account was not approved within 7 days. Activation requests have been canceled. | Resolve any credit issues for the account before sending additional activation requests. |
Error Code | Error Message | Occurs When | Resolution |
---|---|---|---|
INPUT_INVALID.DeviceType | GetDevicePRLInformation cannot be performed on 4G devices. | You sent a GetDevicePRLInformation request for a 4G device. 4G devices don't have PRLs. | Only send GetDevicePRLInformation requests for active 2G and 3G devices. |
GetDevicePRLInformation cannot be performed on Vodafone devices. | You sent a GetDevicePRLInformation request for a Vodafone device. Vodafone devices don't use PRLs. | Only send GetDevicePRLInformation requests for non-Vodafone devices. | |
GetDevicePRLInformation is not supported on deactive devices. | You sent a GetDevicePRLInformation request for a deactive device. PRLs are only used by active devices. | Only send GetDevicePRLInformation requests for active 2G and 3G devices. |
Error Code | Error Message | Occurs When | Resolution |
---|---|---|---|
REQUEST_FAILED.NoSmsrOid | Cannot provide EID without SmsrOid, for go to state request. | The request contained an EID but no SM-SR OID, which is required for EUICC devices. | Include the SmsrOid element and retry the request. |
REQUEST_FAILED.OnlyOneProvidedOfImeiOrEid | Cannot provide IMEI without EID, or vice versa, for go to state request. | The request included an SmsrOid, but either EID or IMEI is missing. | If you are working with an EUICC device, make sure the request includes both the EID and IMEI of the device. If the device is not an EUICC device, do not include the SmsrOid element in the request. |
REQUEST_FAILED.InvalidDeviceKind | Cannot provide ESN, ICCID, IMSI, MEID, MDN or MSISDN when SmsrOid is provided. | The request included device identifier types that cannot be used when an SmsrOid is specified. | If you are working with an EUICC device, make sure the request includes only the EID and IMEI of the device. If the device is not an EUICC device, do not include the SmsrOid element in the request. |
REQUEST_FAILED.ImsiAndImeiAndEid | Cannot provide IMSI when IMEI and EID are provided, or vice versa, for go to state request. | The request included IMEI, EID, and IMSI identifiers. | If you are working with an EUICC device, make sure the request includes only the EID and IMEI of the device. |
REQUEST_FAILED.DeviceNotFound | Could not find device "IMEI : {imei_value}" and "EID : {eid_value}". | Either the IMEI or the EID provided in the request could not be found in the account. | Verify that you have entered the correct IMEI and EID values and then retry the request. |
Error Code | Error Message | Occurs When | Resolution |
---|---|---|---|
REQUEST_FAILED.SmsMessage.NoImsi | Cannot send SMS message to Vodafone device with no IMSI. | The specified device is part of the account, but is not active and has no IMSI. | Activate the device before attempting to send an SMS message to it. |
REQUEST_FAILED.SmsMessage.NoMdn | Cannot send SMS message to device with no MDN. | The specified device is part of the account, but is not active and has no MDN. | Activate the device before attempting to send an SMS message to it. |