Error Reference
This reference lists the error codes returned by the Vela Mobile API.
Error Codes
| Code | Error Message | Reason / Description |
|---|---|---|
| 100 | DB seems to be down | Database is down |
| 102 | Input Format Error | XML authenticated but invalid. |
| 103 | Server Error | Server couldn’t respond to the request |
| 104 | Carrier Seems To Be Down | |
| 501 | Username cannot be blank | Username not passed in XMLs request |
| 502 | Incorrect login credentials | Incorrect username or token |
| 503 | Password cannot be blank | Incorrect Token or PIN |
| 505 | Outage | TMO planned outage |
| 506 | Invalid ESN | Invalid or incorrect SIM/ESN format |
| 508 | Zip code cannot be blank | Zip code field cannot be blank for activation |
| 509 | PIN cannot be blank | PIN is required for XML authentication. |
| 510 | Invalid Zipcode | Invalid Zip code format |
| 512 | Invalid MDN/MDISDN | Incorrect MDN |
| 521 | Invalid Hotline Number | Incorrect hotline number format |
| 527 | Request already in progress | There is a pending transaction. |
| 528 | Wrong SSN Number | Incorrect SSN format |
| 530 | Given date is not valid | Incorrect data format |
| 902 | API Access Denied | API transaction not permitted |
| 906 | Plan Code is Invalid or Inactive | Plan code is either invalid or expired |
| 909 | MDN does not belong to this vendor | MDN isn’t assigned to your account |
| 910 | ESN does not belong to this MVNO | ESN/SIM is not allocated to your account |
| 914 | ESN already active with another MDN | SIM/ESN is already active with an MDN |
| 915 | ESN/MDN is Inactive | MDN or SIM/ESN is not active |
| 916 | SOC Failed To Add. | Failed to add SOC with carrier |
| 917 | Invalid MVNO. | |
| 919 | Invalid SUBSCRIPTIONID | Subscription ID is either invalid or inactive |
| 920 | Invalid UOM | Invalid UOM (Unit of Measurement) |
| 921 | Exceeded max attempts. | Exceeded Maximum transaction limit |
| 969 | Max Purchases limit exceeded | Max Purchases limit exceeded |
| 1023 | XML Format Error | Incorrect XML format |
| 8011 | eSIM Profile already completed and mapped. | eSIM Profile already completed and mapped. |
| 8010 | eSIM Not Available for MVNO | eSIM Not Available for MVNO |
| 9093 | E911 Complete Address Required | STREET1, CITY, STATE, ZIP are mandatory. |
| 9066 | Plan Code Access Denied | Plan code is either invalid or expired |
Network Error Codes
| Code | Error Message | Reason / Description |
|---|---|---|
| GENS-0001 | NGP provided is invalid for ZIP | Zip code mismatch with NGP. |
| GENS-0002 | MSISDN is suspended | Subscriber is suspended. |
| GENS-0004 | System is offline | Connection Error/Tuxedo Service down. |
| GENS-0005 | Unexpected Exception | Internal system error. |
| GENS-0006 | Invalid SIM | ICCID state invalid for request type (e.g. Activate requires New status). |
| GENS-0010 | Duplicate products | Duplicate ProductID or adding already active product. |
| GENS-0011 | No available MSISDNs | No numbers available for NGP/Zip. |
| GENS-0012 | SIM is not associated with MSISDN | ICCID mismatch for the provided MSISDN. |
| GENS-0013 | Invalid MSISDN | Invalid MSISDN or mismatch with IMSI/ICCID/IMEI. |
| GENS-0016 | Cannot reactivate ported out | MSISDN ported to another carrier. |
| GENS-0018 | New SIM is Invalid | New SIM is not valid. |
| GENS-0021 | Parse Exception | Data parsing error not caught by XML gateway. |
| GENS-0030 | SIM range error | SIM not in partner's assigned IMSI range. |
| GENS-0031 | SIM not found | SIM not found in T-Mobile system. |
| GENS-0033 | MSISDN is not suspended | MSISDN or products not in Suspended state. |
| GENS-0034 | ZIP is required | ZIP code missing. |
| GENS-0037 | Either SIM, IMSI, or MSISDN must be provided | Required field missing from request. |
| GENS-0040 | NGP is required | NGP not included in request. |
| GENS-0041 | No Port-In request found for the MSISDN provided | No pending port-in exists for this MDN. |
| GENS-0043 | MSISDN not eligible for Port In | Ineligible for port-in (already used for INTRA port or not eligible for INTER port). |
| GENS-0047 | PortIn Resolution Required | Additional elements needed to complete the port-in. |
| GENS-0048 | Port-in request was cancelled | Port-in already cancelled — submit a new one. |
| GENS-0049 | PortIn request is pending, no modifications required | Port is in-progress; only modifiable when status is "Resolution Required." |
| GENS-0050 | Address incomplete / Invalid OSP Address | Missing or invalid address fields (addressLine1, city, state, zip). |
| GENS-0051 | OSP Account Number is required | Old service provider account number missing. |
| GENS-0052 | Customer Name is required | Customer name not included in request. |
| GENS-0054 | Transaction in progress | Existing transaction already processing. |
| GENS-0062 | SIM is required | SIM/ICCID missing from request. |
| GENS-0063 | MSISDN is required | MSISDN missing from request. |
| GENS-0065 | MSISDN is deactivated | The MSISDN has been deactivated. |
| GENS-0090 | Invalid E911 Address | E911 Address fields contain invalid info. |
| GENS-0109 | GBA validation for WFC failed | SIM failed GBASIM validation for WiFi Calling. |
| GENS-0120 | MSISDN is not active on the network | MSISDN is not active. |
| GENS-0124 | Cannot Update E911, WFC not active | Subscriber does not have WiFi Calling. |
| GENS-0125 | SIM does not match original PortIn request | ICCID mismatch with original port-in submission. |
| GENS-0147 | MSISDN is ineligible for reactivation | MSISDN currently in use, not eligible for reactivation. |
| GENS-0149 | Voicemail is inactive for this subscriber | No voicemail product — nothing to reset. |
| GENS-0150 | T-Mobile systems down | Internal T-Mobile issue. |
| GENS-0161 | The MSISDN is already submitted for port-in | Duplicate port-in request exists. |
| GENS-0170 | WFC requires E911 | WiFi Calling requires E911 details. |
| GENS-0173 | WFC is required for E911 | E911 provided but WFC product missing. |
| GENS-0177 | Invalid language | Language request must be ENGL or SPAN. |
| GENS-0180 | MSISDN already in use | Cannot activate; MSISDN is active. |
| GENS-0183 | Subscriber cannot be suspended, not active | Subscriber not active or already suspended. |
| GENS-0184 | Product ineligible for the specified ZIP | Product not available for this market ZIP. |
| GENS-0185 | MSISDN does not belong to the partner | MSISDN not associated with this partner ID. |
| GENS-0197 | SIM number is already in use | ICCID already in use. |
| GENS-0201 | Unable to modify, transaction in progress | Sync response not received for last provisioning. |
| GENS-0228 | Not eligible for port-out: Active Subscriber not found | MSISDN not associated with an active account. |
| GENS-0250 | Subscriber not found | Subscriber cannot be found with provided info. |
| GENS-0289 | Invalid ZIP | ZIP code is not valid. |
| GENS-0291 | Subscriber is not active | Subscriber is not an active T-Mobile subscriber. |
| GENS-0305 | ZIP or NGP is required | Market ZIP or NGP missing from request. |
| GENS-0374 | Unable to proceed. Port-In Request is in Pending state | A port-in is already pending for this MDN. |
| GENS-0403 | T-Mobile System Timed out. Please Retry | Internal systems timed out. |
| GENS-0404 | Invalid Address | Address provided is invalid. |
| GENS-0417 | MSISDN cannot be different from original PortIn request | MDN mismatch with original port-in. |
| GENS-0425 | MSISDN is in use by another partner | MDN belongs to a different partner. |
| GENS-0440 | Unable to modify while port-out is in progress | Modifications blocked during port-out. |
| GENS-0456 | Due to high volume, please wait and try again | Partner TPM quota exceeded. |
| GENS-0464 | Outage in progress. Please try again later | Planned or unplanned outage. |
Port-In Status / Rejection Codes
When querying port-in status (GET /sim/port-in/status/{mdn}), the upstream carrier may return these codes indicating the current state or reason for rejection. These are distinct from GENS codes and come directly from the porting system.
Pending / Delay Codes
| Code | Description |
|---|---|
| 1B | Workload — carrier processing delay |
| 1C | Network SP not ready |
| 1E | End User not ready |
| 1L | Frame due time cannot be met |
| 1M | Requested due date less than published interval |
| 1N | Due date and time cannot be met |
| 1P | Other (unspecified delay) |
Rejection Codes
| Code | Description |
|---|---|
| 6A | MDN Not Found — unable to locate MDN at old carrier |
| 6B | Same new and old network — port between same network not allowed |
| 6C | Customer information does not match — name/address/account mismatch |
| 6D | MDN not active at old carrier |
| 6E | Due date can't be met |
| 6F | Due time can't be met |
| 6G | Port complexity — requires manual handling |
| 6H | System outages at old carrier |
| 6J | High volume causing delays |
| 6K | Administrative number — not portable |
| 6L | Request received outside of business hours |
| 6M | Port request already pending from another local provider |
| 6N | Port request already pending — duplicate request |
| 6P | MDN has service provider port protection |
| 6R | Carrier cannot process multi-line request |
| 7A | Specific MDN is valid — errors with other MDNs on request |