This page lists all error codes and corresponding error messages for the synchronous 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.AccountNotFoundDeviceService.INPUT_INVALID.CustomField.InvalidNameThe 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 list of error codes and error messages for the asynchronous Callback API responses, see Callback Errors.
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.Request.InvalidCharacter | There was an invalid character (' or < or \) in your input. | One of the fields in the request had an illegal character. | Do not use the apostrophe, less than sign, or backslash in your input. |
| INPUT_INVALID.RequestUndefined | Request cannot be blank. Please provide request details. | The incoming request message is empty. | Verify your code to be sure that you are sending a complete SOAP request for the specific API. |
| 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. |
| DeserializationFailed | The formatter threw an exception while trying to deserialze... Expecting element 'element name'. | The required element element name was not included in the request, or the elements were in the wrong order. | Verify that the request contains all required elements in the order shown in the documentation 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.SessionToken.Expired | The Session has expired. | An API request was sent with an expired session token in the header. (Session tokens expire after 20 minutes of inactivity.) | Log in again to obtain a new session token, and then retry the request with the new token. |
| REQUEST_FAILED.SessionToken.Format | The token is not passed in the correct format. | The session token was not in the SOAP header. | Verify that your application is including the session token in the SOAP header. |
| INPUT_INVALID.SessionToken.Invalid | The session token was not a valid GUID. | The token in the request header was not a valid session token. | Verify that your application is storing the session token returned by the LogIn API method and including it in the SOAP header. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.Account.NotDefined | Account name is a required field. | The request did not include an account name. | Include an account name and send the request again. |
| REQUEST_FAILED.AccountName | The specified contact is not associated with the specified account or the account name cannot be found. | The web services username that you signed in with is not associated with the account name given in the request. | Verify that you are using the correct login credentials for the account that you want to work with. |
| REQUEST_FAILED.AccountNotFound | Could not find account "{account name}". | The account name given in the request does not exist in the ThingSpace Platform. | Verify the spelling of the account name and retry the request. |
| REQUEST_FAILED.NoAccounts | The contact has no associated accounts. | The web services username that you signed in with is not associated with any accounts. | Verify that you are using the correct login credentials for the account that you want to work with. |
| REQUEST_FAILED.MultipleAccounts | The Contact is associated with multiple accounts. Please supply account name. | The web services username that you signed in with has access to more than one account, and you did not include an account name in the request. AccountName is a required field when you have access to multiple accounts. | Specify the account that you want to use in the API request. |
The APIs that accept device identifiers check for validity of those identifiers according to the rules described here.
The Kind element specifies the type of identifier, such as MEID, ESN, or MDN. The Identifier element specifies the value of the identifier. Depending on the Kind of the device identifier, the Identifier element text string could contain:
You do not need to prepend identifier values with the "0x" or "0h" prefix to indicate that a value is decimal or hexadecimal. The ThingSpace Platform sends an INPUT_INVALID.Device.Identifier.Invalid SOAP fault if the identifier is not in the format required by the Kind element.
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.BothDeviceListAndDeviceFiltersDefined | Only one of a non-empty device list or device input filter criteria (group, custom fields, service plan) may be defined in the request, but not both. | Your request included a DeviceList and a DeviceGroupName, DeviceServicePlanFilter, or DeviceCustomFieldFilter. You cannot use filters if you use a DeviceList. | Retry the request with just a DeviceList, or with one or more of the filters. |
| 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. | Set the Identifier element to a value that is in the format required by the Kind element, and then resend the request. |
| INPUT_INVALID.Device.Identifier.NotDefined | The Identifier value of Device must contain a value. | 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.Device.Identifier.Null | A device identifier in the collection cannot be null. | The request included a null DeviceIdentifier in the DeviceIdentifierCollection. | Verify that you are setting at least one Kind and Value for each DeviceIdentifier in the DeviceIdentifierCollection, and then retry the request. |
| INPUT_INVALID.Device.Kind.Invalid | The device kind was not recognized as valid. Valid ones are ICCID, MEID, IMSI, MDN, IMEI, MSISDN, or ESN. | The "Kind" field for DeviceIdentifier did not contain a recognized value. | Retry the request with "Kind" set to one of the valid values. |
| INPUT_INVALID.Device.Kind.NotDefined | The Kind value of Device must contain a value. | The "Kind" field for DeviceIdentifier was empty. | Retry the request with "Kind" set to one of the valid values. |
| INPUT_INVALID.DeviceListAccountNameAndDeviceGroupDefined | Account, device list, and device group are not a valid combination. Please provide one or a valid combination (device list + account or device group + account) | The request included both DeviceList and DeviceGroupName parameters, which is not a valid combination. | Remove the DeviceList or DeviceGroupName parameter and then retry 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.NoDeviceIdentifierInCollection | A device identifier collection must have at least one device identifier. | The DeviceIdentifierCollection element in the request did not contain any DeviceIdentifier elements. | Include at least one DeviceIdentifier element in the DeviceIdentifierCollection. |
| INPUT_INVALID.NoDeviceListAccountNameOrGroup | Account, device list, and device group are empty. Please provide a valid combination. | The request did not include any parameters to identify the devices to work with. | Add a DeviceList, or DeviceGroupName and AccountName, and then retry the request. |
| INPUT_INVALID.NoDeviceListOrDeviceFilters | The request must have either a non-empty device list or device input filter criteria (group, custom fields, service plan) defined. | Your request did not include a DeviceList or a DeviceGroupName, DeviceServicePlanFilter, or DeviceCustomFieldFilter. | Create the request with either a DeviceList, or one or more of the filters. |
| REQUEST_FAILED.DeviceNotFound | Could not find device "{kind} {identifier}". | The device identifier in the request did not match any devices in the account. | Verify the device identifier and retry the request. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.CustomField.InvalidName | Only the values CustomField1, CustomField2, CustomField3, CustomField4, and CustomField5 are permitted. | The request included a Name value for a custom field that was not one of the five allowed values. | Set the custom field Name element to one of the allowed values. |
| INPUT_INVALID.CustomField.NotDefined | A custom field cannot be null. | The request included a null Value element for a custom field. | Use a string value for the custom field. |
| INPUT_INVALID.CustomField.TooLong | A custom field cannot be more than 50 characters long. | The Value element in a custom field was too long. | Retry the request with a custom field Value that is no more than 50 characters long. |
| INPUT_INVALID.CustomFieldValue.InvalidCharacter | The value of custom field {custom field name} contains invalid character(s). | The Value element in a custom field included one or more characters that are not allowed. | Only use alphanumeric characters in custom field values, plus a few punctuation marks (no question marks). |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.RequestId.NotDefined | RequestId is a required field. | The GetRequestStatus request did not include a request ID. | Provide the unique ID of the request that you want the status of, and retry the request. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.Comparator.NotDefined | Comparator is a required field. | The create or update trigger request did not include a comparator. | Include the comparator field and a value, and retry the request. |
| INPUT_INVALID.Comparator.Invalid | The comparator was not recognized as valid. Valid values are lt, gt. | The comparator value was not one of the valid choices. | Set the comparator to "gt" or "lt" and retry the request. |
| INPUT_INVALID.CycleType.Invalid | The cycle type was not recognized as valid. Valid values are Daily, Weekly, Monthly. | The cycle time in the request was not one of the valid values. | DeviceSmsUsage and DeviceDataUsage triggers track usage during a cycle. Valid cycle times are Daily, Weekly, or Monthly. |
| INPUT_INVALID.CycleType.NotDefined | CycleType is a required field. | The request to create or update a trigger did not include the CycleType parameter. | Include the CycleType parameter and set the value to Daily, Weekly, or Monthly, and then retry the request. |
| INPUT_INVALID.SmsType.Invalid | The SmsType was not recognized as valid. Valid values are MO, MT, MOMT. | The request included an invalid SmsType. | Set the SmsType value to one of the recognized values (MO, MT, or MOMT) and then retry the request. |
| INPUT_INVALID.SmsType.NotDefined | SmsType is a required field. | The request did not include the SmsType parameter, or the value was null. | Verify that your request includes SmsType set to a valid value, and then retry the request. |
| INPUT_INVALID.TriggerName.NotDefined | Trigger name is a required field. | The request to create or update a trigger did not include a trigger name. | Verify that the request includes the TriggerName parameter and then retry the request. |
| INPUT_INVALID.TriggerCategory.Invalid | The trigger category was not recognized as valid. Valid values are DeviceSmsUsage, DeviceDataUsage, DeviceSessionTime. | The TriggerCategory in the request was not one of the accepted options. | Set the TriggerCategory to DeviceSmsUsage, DeviceDataUsage, or DeviceSessionTime and then retry the request. |
| INPUT_INVALID.TriggerCategory.NotDefined | Trigger category is a required field. | The request did not include the TriggerCategory parameter. | Set the TriggerCategory to DeviceSmsUsage, DeviceDataUsage, or DeviceSessionTime and then retry the request. |
| INPUT_INVALID.Threshold.NotDefined | Threshold is a required field. | The request did not include a threshold for the trigger. | Verify that the request includes the Threshold parameter set to the value at which you want the trigger to activate, and then retry the request. |
| INPUT_INVALID.Threshold.Invalid | The threshold provided was not in a valid format. | The threshold value was not an integer. | Set the threshold value to an integer and retry the request. |
| REQUEST_FAILED.UnexpectedError | AccountName cannot be changed. | The UpdateTrigger request contained a different account name than the account that the trigger belongs to. | Remove the AccountName and retry the request. You cannot move a trigger from one account to another; you must create the trigger in the desired account. |
| REQUEST_FAILED.UnexpectedError | Category cannot be changed. | The UpdateTrigger request contained a different TriggerCategory value than the value originally set for the trigger. | You cannot change the TriggerCategory of a trigger; you must create a new trigger with the desired TriggerCategory. To update the existing trigger, set the TriggerCategory field to the original value and make changes to other values. |
| REQUEST_FAILED.UnexpectedError | Can not find the trigger with triggerId: {trigger ID} | The trigger ID provide in the UpdateTrigger request does not match any existing triggers. | Verify the trigger ID and retry the request. If the ID is still not found, the trigger does not exist in the account. |
| REQUEST_FAILED.UnexpectedError | triggerName is already in use. Please choose another triggerName. | The request to create or update a trigger used the name of another existing trigger. | Trigger names must be unique. Set a unique trigger name and retry the request. |
| REQUEST_FAILED.UnexpectedError | No triggers found for triggerId: {trigger ID} | The trigger ID in the GetTriggers request was not found. | Verify the trigger ID and retry the request. If the ID is still not found, the trigger has been deleted. |
| REQUEST_FAILED.UnexpectedError | TriggerId is invalid. | The trigger ID in the request is not in a valid format. | Verify the trigger ID and retry the request. If you continue to get this error, the trigger does not exist in the account. |
| REQUEST_FAILED.UnexpectedError | threshold must be greater than zero. | The request contained a threshold value that is a negative number or zero. | Set the threshold value to a positive number and retry the request. |
| INPUT_INVALID.Trigger.NotDefined | Request must include SmsTrigger or DataTrigger Or SessionTrigger. | The request did not include the parameters needed based on the TriggerCategory. | Verify that the request includes all required fields as defined in the documentation, and then retry the request. |
| INPUT_INVALID.ThresholdUnit.Invalid | The threshold unit was not recognized as valid. Valid values are KB, MB, GB, or TB. | The DeviceDataUsage trigger request did not include one of the accepted values for ThresholdUnit. | Use one of the valid values and retry the request. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.ServiceName.Invalid | An invalid service name was provided, valid service names are "EnhancedConnectivityService", "PromoChanges", "ExternalProvisioningChanges", "DeviceUsage", "CarrierService", "ResumeTrackingNotification", "DevicePRLInformation", and "SMSDeliveryConfirmation". | The service name in the request was not one of the allowed service names. | Resend the request with one of the allowed service names. |
| INPUT_INVALID.ServiceName.IsEmpty | The service name cannot be empty. | The service name field in the request was empty. | Resend the request with one of the allowed service names. |
| INPUT_INVALID.ServiceName.NotAlphanumeric | The service name must contain only alphanumeric characters. | The service name in the request contained punctuation or some other non-alphanumeric characters. | Resend the request with one of the allowed service names. |
| INPUT_INVALID.Url.Invalid | Please specify a properly formatted Url. | The URL in the request did not include all required elements. |
Resend the request with the URL in the form protocol://path-to-your-callback-listening-service such
as http://mycompany.com/CallbackListener.
|
| INPUT_MISSING | Please provide either account name or account number. | The GetDeviceInformation request must have either an account name or an account number. | Resend the request and specify either the account name or account number. |
| REQUEST_FAILED.CallbackExists | A callback service is already registered for this service. | The account already has a URL registered for the service name included in the request. | Use GetCallbackRegistrations to see a list of existing registrations for the account. To replace an existing registration, use UnregisterCallback and then RegisterCallback. |
| REQUEST_FAILED.Callback.NotRegistered | No callback was registered for the Account and Service you specified. | You attempted to unregister for a callback service, but the specified account does not have a URL registered for that service. | Use GetCallbackRegistrations to see a list of existing registrations for the account. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.Account.MoveDeviceUnavailable | This account is not enabled for Move Device | The account that you are logged into is not enabled for Move Device | Talk to your Verizon account representative about account changes required for MoveDevice. |
| INPUT_INVALID.AccountName | An account name was not specified but is required for this action. | The request did not included an account name. | Specify an account name and retry the request. |
| INPUT_INVALID.AccountNotUnderSameCustomerProfile | Both the current and new accounts must be under the same Customer profile | The account that you are logged into and the account in the AccountName parameter are not in the same profile. | Verify that the account in the AccountName parameter is in your customer profile, 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.AddressIncomplete | AddressLine1, City, State, Zip, and Country are required when providing address for PrimaryPlaceofUse. | One or more of the following required values is missing: * AddressLine1 * City * State * Zip | Resubmit the request with all of the required values. |
| INPUT_INVALID.BothLeadIdandPrimaryPlaceofUseProvided | Include either the LeadId or PrimaryPlaceOfUse; not both. | The ChangeDeviceState-Activate request contained values for both the Lead ID and PrimaryPlaceOfUse parameters. | For VPP partner accounts, resubmit the activation request with a Lead ID. For non-VPP customers, resubmit the request with PrimaryPlaceOfUse values. |
| INPUT_INVALID.CarrierIpPoolNotFoundInNewAccount | The carrier IP pool was not found in the new account. | The new account does not have an IP Pool with the name specified in the CarrierIpPoolName parameter. | Verify the name of the IP Pool, or leave CarrierIpPoolName blank to have the device IP address come from the default pool in the new account. |
| INVALID_INPUT.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.Change4GOption.Invalid | An invalid Change4GOption was provided. Valid Change4GOptions are "ChangeIMEI", "ChangeICCID", "ChangeIMEIANDICCID", "ChangeMSISDN", "3GTo4G", and "4GTo3G". | The request did not contain one of the recognized Change4GOption values. | Retry the request with a valid Change4GOption. |
| INPUT_INVALID.ChangeDeviceIdentifierToESNOrMEIDMissing | An ESN or MEID was not specified for ChangeDeviceIdentifierTo but is required for this request. | The 4Gto3G option requires either an ESN or an MEID value in the ChangeDeviceIdentifierTo parameter. The request did not contain either of those device identifier types. | Retry the request with a valid ESN or MEID. |
| INPUT_INVALID.ChangeDeviceIdentifierToICCIDMissing | An ICCID was not specified for ChangeDeviceIdentifierTo but is required for this request. | The ChangeICCID and ChangeICCIDandIMEI options require a new ICCID value in the ChangeDeviceIdentifierTo parameter. | Retry the request with a valid ICCID value. |
| INPUT_INVALID.ChangeDeviceIdentifierToIMEIMissing | An IMEI was not specified for ChangeDeviceIdentifierTo but is required for this request. | The ChangeIMEI and ChangeICCIDandIMEI options require a new IMEI value in the ChangeDeviceIdentifierTo parameter. | Retry the request with a valid IMEI value. |
| INPUT_INVALID.ChangeDeviceIdentifierToMDNInfoMissing | AssignNonGeoMDN, NPA-NXX, or Zip Code must be provided. | The ChangeMSISDN request did not include parameters from which to derive a new MSISDN/MDN. | Retry the request with a valid combination of values for AssignNonGeoMDN, MdnZipCode, and MdnNpaNxx. |
| INPUT_INVALID.ChangeDeviceIdentifierToMissing | ChangeDeviceIdentifierTo was not specified but is required for this request. | The request did not contain the ChangeDeviceIdentifierTo parameter, or the value was null. | Retry the request with a valid ChangeDeviceIdentifierTo value. |
| INPUT_INVALID.Country | Country can be either US or USA. | The Country parameter does not contain US or USA. | Resubmit the request with a valid Country parameter. |
| 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 or false. |
| INPUT_INVALID.Device.InvalidChangeDeviceIdentifierKind | Cannot provide ChangeDeviceIdentifier Kind as IMEI, ICCID, IMSI or MSISDN or MDN. Valid values are ESN, MEID | The ChangeDeviceIdentifier request included an invalid value for the Kind parameter. | Set the Kind value to either ESN or MEID. |
| INPUT_INVALID.Device.Kind.InvalidWithSkuNumber |
Cannot provide SKU when specifying device type
|
The request contained a SkuNumber value and a device type other than ICCID. At this time, the SkuNumber parameter can only be used with ICCID identifiers. | Remove the SkuNumber and then resend the request, or keep the SkuNumber and only include ICCID identifiers. |
| INPUT_INVALID.Device.Not3G | The device is not a 3G device. | The 3Gto4G option requires a 3G device in the DeviceIdentifiers parameter. The device specified is not a 3G device. | Verify the current device ID and then resend the request. |
| INPUT_INVALID.Device.Not4G | The device is not a 4G device. | The device specified in the Change4GDeviceIdentifier request is not a 4G device. | Use the ChangeDeviceIdentifier API for 2G/3G devices. If you need to change an identifier for a 4G device, verify the current device ID and then resend the request. |
| 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.DeviceGroupNotFoundInNewAccount | The Device Group was not found in the new account | The new account does not have a device group with the name specified in the DeviceGroupName parameter. | Verify the name of the device group, or leave DeviceGroupName blank to put the devices into the default device group in the new account. |
| INPUT_INVALID.DeviceState.Invalid | The given device state is invalid, valid State values are Active, Active.Ready and Active.Test | A Deactivate or Suspend request specified a device that is not in an Active state. | Follow the best practice to determine a device's current state before sending a ChangeDeviceState request. Only Active devices can be deactivated or suspended. |
| INPUT_INVALID.FeatureCode.NotDefined | A feature code cannot be blank. | The FeatureCodesToAdd or FeatureCodesToRemove field did not contain a value. | Specify the feature code that you want to add or remove, and then retry the request. |
| INPUT_INVALID.FeatureCodes.AddedAndRemoved | Cannot both add and remove feature(s) {feature codes} at the same time. Can only do one or the other. | The same feature code was included in the FeatureCodesToAdd and FeatureCodesToRemove values. | Modify the request to either add or remove the feature code, and then retry the request. |
| INPUT_INVALID.FeatureCodesToAdd.Duplicate | Feature(s) {feature codes} cannot be added more than once. | A request to add feature codes included the same feature code more than once, or was for feature codes that are already enabled for the device. | Verify that the feature codes that you want to add are not already enabled for the devices in the request. Retry the request, making sure that each feature code only appears once. |
| INPUT_INVALID.FeatureCodesToRemove.Duplicate | Feature(s) {feature codes} cannot be removed more than once. | |A request to remove feature codes included the same feature code more than once. | Retry the request, making sure that each feature code only appears once. |
| INPUT_INVALID.InvalidAccountTypeForNpaNxxOrZip | Telematics customer cannot select Mdn by Zip or Npa-Nxx | ||
| INPUT_INVALID.LeadIdSent | The LeadId is not applicable to your account. | The request included a value for LeadId, but the account does not use leads. | Resubmit the request without the LeadId. |
| INPUT_INVALID.Lte.ChangeDeviceId | Cannot set MEID or ESN for an LTE device. | A ChangeDeviceIdentifier request was sent for a 4G LTE device. | ChangeDeviceIdentifier can only be used for 2G/3G devices. |
| INPUT_INVALID.MaxRequestsExceeded | Request contains more devices than the maximum allowable of 10000. | A request was sent that included more than 10,000 devices. | Send several requests instead of one request, each containing less than 10,000 devices. |
| INPUT_INVALID.MdnNpaNxx.Invalid | The Mdn Npa-Nxx provided was not in a valid format; it must be exactly 6 numeric digits. | The MdnNpaNxx field field did not contain the right number of digits, or contained other characters. | Set the MdnNpaNxx value to a 6-digit value and retry the request. |
| INPUT_INVALID.MdnZipCode | The Mdn Zip Code provided was not in a valid format. | The MdnZipCode field did not contain the right number of digits, or contained other characters. | Set the MdnZipCode value to a 5-digit value and retry the request. |
| INPUT_INVALID.MdnZipCodeMissing | An MDN Zip code must be provided. | The request did not include a value for the MdnZipCode field. | Set the MdnZipCode field to the ZIP code from which the MDN will be derived, and retry the request. |
| INPUT_INVALID.MdnZipCodeRequiredForB2BNonGeo | MDNZipCode is required to assign Non-Geo MDN for B2B carriers. | The request did not include the required MdnZipCode value for a non-geo MDN change. | Retry the request with an MdnZipCode value. |
| INPUT_INVALID.MissingCustomerName | Both FirstName and LastName are required when providing PrimaryPlaceOfUse. | One or more of the following required values is missing: * FirstName * LastName | Resubmit the request with all required name values. |
| INPUT_INVALID.MoreThan2Deviceidentifiers | ChangeDeviceIdentifierTo contained more than 2 device identifiers. Please provide only 2 device identifiers. | The ChangeICCIDandIMEI option requires two new device identifier values in the ChangeDeviceIdentifierTo parameter, one for ICCID and one for IMEI. The request included more than those two identifiers. | Provide one ChangeDeviceIdentifierTo parameter that contains a new ICCID and a new IMEI. |
| INPUT_INVALID.MultipleChangeDeviceidentifierTo | ChangeDeviceIdentifierTo was specified more than once. Please provide a single device identifier. | The request included more than one ChangeDeviceIdentifierTo parameter. | Provide one and only one ChangeDeviceIdentifierTo parameter. |
| INPUT_INVALID.MultipleICCIDPresent | ChangeDeviceIdentifierTo contains more than one ICCID. Please provide a single ICCID. | The request included more than one ICCID in the ChangeDeviceIdentifierTo parameter. | Retry the request with one and only one ICCID value in the ChangeDeviceIdentifierTo parameter. |
| INPUT_INVALID.MultipleIMEIPresent | ChangeDeviceIdentifierTo contains more than one IMEI. Please provide a single IMEI. | The request included more than one IMEI in the ChangeDeviceIdentifierTo parameter. | Retry the request with one and only one IMEI value in the ChangeDeviceIdentifierTo parameter. |
| INPUT_INVALID.MultipleStateChanges | {# actions} change state actions were specified. One and only one is expected. | The ChangeDeviceState request included more than one state. | Provide one and only one change state action element (e.g. cannot activate and suspend in the same request). Set all other change state action elements to null. |
| INPUT_INVALID.NoCarrierSpecified | Specified Account has multiple carriers associated with it, carrier field may not be null. | The Activate request did include not a CarrierName value. | If you have access to multiple carriers, you must specify which carrier a device will have service with when activating it. |
| INPUT_INVALID.NoStateChanges | No change state actions were specified. One and only one is expected. | The ChangeDeviceState request did not include a device state. | Set a non-null value for one of the change state action elements (e.g. activate, deactivate, etc…). |
| INPUT_INVALID.NpaNxxAndZipCodeProvided | Cannot provide both MDN Npa-Nxx and Zip Code. | The request included values for both the MdnNpaNxx and MdnZipCode fields. | Set a value for either the MdnNpaNxx or the MdnZipCode and retry the request. |
| INVALID_INPUT.NPANXXRequiredForB2B | NPANXX is Required to perform Change MDN for B2B carriers. | ChangeDeviceIdentifier request for a device on a B2B carrier did not include a value for MdnNpaNxx. | Set a value for the MdnNpaNxx parameter and retry the request. |
| INPUT_INVALID.PublicIPRestriction.Invalid | An invalid PublicIPRestriction was provided. Valid service names are "Restricted", "Unrestricted". | A value other than "restricted" or "unrestricted" was used for the PublicIPRestriction parameter. | For devices on the public network, use one of the allowed values or leave it empty to use the account default value. |
| INPUT_INVALID.ReasonCodes.ActionInvalid | Action for getting reason codes is invalid. Only valid one is: Deactivate. | You included a ReasonCode in a ChangeDeviceState request that was not a deactivate request. | Retry the request without the ReasonCode. |
| INPUT_INVALID.ServicePlanMissing | A service plan needs to be sent along with the request. | 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.ServicePlanNotFoundInNewAccount | The service plan was not found in the new account. | The new account does not have a service plan with the code specified in the ServicePlan parameter, or no plan code was specified and the new account does not have a plan with the same code as the service plan in the current account. | Put an existing service plan code from the new account in the ServicePlan parameter and resend the request. |
| INPUT_INVALID.SkuNumber.Invalid | Invalid SKU provided. A valid SKU is an alphanumeric string with up to 20 characters | The SkuNumber field contained unrecognized characters, or the value was too long. | Use a SKU that is no more than 20 characters long and that only contains letters and numbers, and then resend the request. |
| INPUT_INVALID.TakeEffect.Value | TakeEffect must be either null, BackDate, or FutureDate | The TakeEffect parameter in the ChangeDeviceServicePlan request had an invalid value. | Set the TakeEffect parameter to either null or "BackDate." No other values are allowed. |
| INPUT_INVALID.ToDeviceExists | ChangeDeviceIdentifierTo device already exists. | The device specified in the ChangeDeviceIdentifierTo parameter is already in the ThingSpace Platform database. | Use a different device identifier that is not already in the database, or send a DeleteDevices request to remove the existing device from the database, then retry the request. |
| INPUT_INVALID.UpdateDeviceInformation.DeviceId | A new ESN, MEID, MDN, NPA-NXX, or Zip Code must be given. | The request did not include the required fields for changing the device identifier. | The request must include a new ESN, MEID, or MDN, or an MdnNpaNxx or MdnZipCode from which to derive the new identifier. |
| INPUT_INVALID.UpdateDeviceInformation. MdnInfoProvidedWithOtherDeviceIdentifier |
Cannot provide new ESN or MEID to update if MDN, Zip Code or NPA-NXX are also provided. | The request included some mutually-exclusive values. | Do not include a value for ESN or MEID if you are setting values for MDN, MdnZipCode, or MdnNpaNxx. |
| REQUEST_FAILED.CarrierRequestUnsuccessful | IP Address: xxx.xxx.xxx.xxx is invalid | Verify the IP address is in the correct format and is valid. | |
| REQUEST_FAILED.CarrierRequestUnsuccessful | IP Address: xxx.xxx.xxx.xxx should not be provided for this service plan: ServicePlanName | Verify the service plan is on a Private Static network. | |
| REQUEST_FAILED.CarrierNotOnAccount | The requested carrier is not a part of this account. | The CarrierName given in the ChangeDeviceState request is not associated with the account. | Verify the name of the carrier and retry the request. Note that if the account only has one carrier, you do not need to include the CarrierName field in the request. |
| REQUEST_FAILED.ReasonCodeNotFound | Could not find reason code "{reason code}". | The request contained an unrecognized value for ReasonCode. | Provide a valid reason code that your organization has access to. |
| REQUEST_FAILED.RequestNotFound | Could not find request "{requestID}". | The request identifier in the request did not match any asynchronous requests in the account. | Verify the request ID and retry the request. |
| REQUEST_FAILED.ServicePlan.NotFound | 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. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.DeviceGroup.MaxDevicesExceeded | Request contained more devices than the allowed maximum 200 devices per request. | The request included too many devices for the API method. | Send multiple requests, each one containing no more than 200 devices. |
| INPUT_INVALID.DeviceGroup.DeleteDefault | Cannot delete the default device group. | You attempted to delete the default device group, which is not allowed. | The default device group automatically contains all devices. The group name can be changed, but the group cannot be deleted. |
| REQUEST_FAILED.DeviceGroup.Exists | That group name already exists for this account. | You attempted to add or update a device group and give it the same name as an existing device group. | Retry your request using a different value for GroupName. |
| INPUT_INVALID.DeviceGroup.RepeatDeviceIdentifier | A request may not contain the same device to both add and remove. | The UpdateDeviceGroup request included the same device in both the DevicesToAdd and DevicesToRemove fields. | Determine whether you want to add or remove the device from the group, and then retry the request. |
| INPUT_INVALID.DeviceGroup.InvalidFormat | Device group name can only contain alphabet, number, space, underscore, or colon, and must start with an alphabet. | The device group name contained an illegal character. | Verify that the device group name only contains letter, numbers, underscores and colons, and that it starts with a letter. |
| INPUT_INVALID.DeviceGroup.TooLong | Device group name cannot be more than 100 characters long. | The device group name was too long. | Use a shorter name and retry the request. |
| REQUEST_FAILED.InvalidDeviceIdentifier | InValid device identifier(s) present in {devicesToAdd/devicesToRemove}. Device was not found for following DeviceIdentifier(s) :- [{list of device identifiers}] , in account {account name} | The request included some device identifiers that don't belong to the account. | Verify the list of device identifiers that you want to add or remove from the group, and then retry the request. |
| INPUT_INVALID.DeviceGroupNameRequired | Device Group Name cannot be blank. | There was no value for the GroupName field. | Set a value for the GroupName field and retry the request. |
| REQUEST_FAILED.DeviceGroupNotFound | Could not find device group "device group name". | 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. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.DeviceProfileAction | An invalid DeviceProfileAction was provided. Valid action names are "Enable", "Disable","Delete","Download_Enable","Download_Disable" | You did not provide a valid profile action in the ChangeDeviceProfileState request. | Set the value of the DeviceProfileAction element to one of the valid actions and retry the request. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.AddDevices.Device.Kind.Invalid | Device kind is not recognized as valid. Valid ones for adding a device are MEID, ESN, ICCID, or IMEI. | The AddDevices or ChangeDeviceState - Activate request contained an MDN or MSISDN. | Resend the request using the MEID or ESN for 3G devices, and both the IMEI and ICCID for 4G devices. |
| INPUT_INVALID.DateTime.InvalidRange | The start date must come before the end date. | The start date in the TimestampFilter is not earlier than the end date. | Set correct values in the TimestampFilter and retry the request. |
| INPUT_INVALID.Device.AssignToMultipleGroups | Cannot assign a device to multiple groups. | The AddDevices request contained more than one string in the DeviceGroupName element. | Specify only one DeviceGroupName and retry the request. |
| INPUT_INVALID.Device.OnlyOneProvidedOfImeiOrEidOrSmsrOId_Code | Cannot provide EID without IMEI and SMSROID, or vice versa, for adding a device. | The request did not include all values required to add an eUICC device. | Verify that the request includes an IMEI, EID, and SmsrOid and retry the request. |
| INPUT_INVALID.Device.OnlyOneProvidedOfImeiOrEidOrSmsrOId_Code | Cannot provide EID without IMEI and SMSROID, or vice versa, for adding a device. | The request did not include all values required to add an eUICC device. | Verify that the request includes an IMEI, EID, and SmsrOid and retry the request. |
| INPUT_INVALID.Device.OnlyOneProvidedOfImeiOrIccid | Cannot provide IMEI without ICCID, or vice versa, for adding a device. | An AddDevices 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.DeviceInformationRequired | Device Information is required. | The AddDevices request did not include a DevicesToAdd element. | Provide a non-null input for DevicesToAdd element in AddDevices request. |
| INPUT_INVALID.DeviceStateFilter | Invalid device state. Valid one is Preactive. | You did not set the State element to "Preactive" in the AddDevices request. | Set the value of the State element to "Preactive" and retry the request. |
| INPUT_INVALID.DeviceStateFilter | Invalid device state filter | The GetDeviceList request included an invalid value for DeviceStateFilter. | Use one of the recognized device states for the DeviceStateFilter, such as "active" or "suspend." See GetDeviceList for the complete list. |
| INPUT_INVALID.LargestDeviceIdSeen.MaxValue | The LargestDeviceIdSeen cannot be more than 2147483647. | The LargestDeviceIdSeen value is too large. | Provide a value less than 2,147,483,647. See the response from the previous request for a suggested value. |
| INPUT_INVALID.NumberofDevices | Only 200 or less devices are allowed at one time | The request included more than 200 devices. | Resend the request as multiple requests, each with no more than 200 devices. |
| REQUEST_FAILED.CallbackNotExists | No DeviceUsage callback was registered for the Account | You sent a GetAggregateDeviceUsage or GetRatedDeviceUsage request before registering for DeviceUsage callback messages. Device usage information is only returned in callback messages. | Create a callback listener for DeviceUsage messages and then use RegisterCallback to tell the ThingSpace Platform where to send those messages. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.SmsMessage.Null | SmsMessage cannot be null. | The SendSmsMessage request did not include a value for SmsMessage. | Set the SmsMessage value to the string that you want to send to the devices, and then retry the request. |
| INPUT_INVALID.SmsMessage.TooLong | An 8-bit SMS message cannot be more than 140 characters long. | The SMS message was too long. | Shorten the SMS message text to less than 140 characters (8-bit) and resend the request. |
| INPUT_INVALID.SmsMessage.TooLong | A 7-bit SMS message cannot be more than 160 characters long. | The SMS message was too long. | Shorten the SMS message text to less than 160 characters (7-bit) and resend the request. |
| INPUT_INVALID.SmsMessage.AdjacentNullCharacters | SmsMessage cannot contain two adjacent null characters. | The SMS message contained two or more null characters next to each other. | Remove adjacent null characters from your SMS message and retry the request. |
| INPUT_INVALID.SmsMessage.InvalidEncoding | Please specify valid encoding. Valid Encoding types are 7-bit, 8-bit-ASCII, 8-bit-UTF-8 or 8-bit-DATA encoding. | The value of the Encoding field was not recognized. | Set the Encoding value to one of the allowed strings and then retry the request. |
| INPUT_INVALID.SmsMessage.InvalidEncodingStringPassed | Please specify base64 encoded string for 8-bit SMS. | The SmsMessage in the request was not encoded in base64. | Convert messages that do not use the universal ASCII character set to base64 before sending them as SMS messages. |
| INPUT_INVALID.PreviousToken.InvalidFormat | The PreviousToken was not a valid GUID. | The PreviousToken value in the request was not in the correct format. | Leave the PreviousToken element empty in the first request, and then use the Token value from the response in the next request. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.Login.BlankUsername | Username cannot be blank. | The username field was empty. | Include your web services account username in the LogIn request. |
| INPUT_INVALID.Login.BlankPassword | Password cannot be blank. | The password field was empty. | Include your web services account password in the LogIn request. |
| INPUT_INVALID.Login.Invalid | Username or Password is incorrect. | The username/password combination was invalid. | Verify the credentials for your web services account and then send another LogIn request. |
| INPUT_INVALID.Login.UserLocked | Your contact record is locked. | The contact record has been locked due to too many invalid LogIn attempts. | {{Contact Support}} |
| REQUEST_FAILED.User.RequiredRole | This user does not have the Role required to access Unified Web Services. | The web services user account does not have permission to create API sessions. | {{Contact Support}} |
| INPUT_INVALID.Password.Incorrect | Specified password is not correct. | The request did not include the correct old (current) password. | Retry the request, being sure to include the correct password. |
| Error Code | Error Message | Occurs When | Resolution |
|---|---|---|---|
| INPUT_INVALID.ServiceNameNotFound | No Service Name was found matching the name "service_name" | The service name specified in the request does not exist in the account. | Verify the service name and retry the request. |
| INPUT_INVALID.StageStateNotFound | No Stage State was found matching the name "state_name" | The state name specified in the request does not exist in the account. | Verify the state name and retry the request. |
| INPUT_INVALID.PrimaryPlaceOfUse.NotDefined | PrimaryPlaceOfUse is required for this state change. | The goToState request did not include primaryPlaceOfUse values. | Some state changes required values for the Primary Place of Use for the line of service, for taxation purposes and/or to know how to contact the customer, if needed. Provide values for the PrimaryPlaceOfUse object and retry the request. |