Status Indexes

Status Index Reference Guide

The Status Index is a proprietary 2-character code that describes key attributes of a mobile account associated with a phone number.

Important: Not all values are supported by every carrier. This guide should be used to interpret values returned by the API. Some statuses (such as Hybrid and Absent) are legacy values and may no longer be returned by modern carriers.


Format

The Status Index consists of two characters:

PositionDescription
Character 1Account Type + Account Status
Character 2Account Role + Customer Type

Example

ec
  • e = Postpaid, Active
  • c = Owner, Personal

Character 1: Account Type & Status

Account Types

TypeDescription
UnknownCarrier did not provide account type
PrepaidPaid before service usage
PostpaidBilled after service usage
Hybrid*Legacy value

Account Statuses

StatusDescription
ActiveAccount is active
SuspendedAccount is temporarily suspended
DeactivatedAccount has been deactivated
UnknownCarrier did not provide status
Absent*Legacy value
  • Legacy values are generally no longer returned by carriers.

Character 1 Mapping

CodeAccount TypeAccount Status
1UnknownUnknown
2UnknownDeactivated
3UnknownSuspended
4UnknownAbsent
5UnknownActive
APrepaidUnknown
BPrepaidDeactivated
CPrepaidSuspended
DPrepaidAbsent
EPrepaidActive
QHybridUnknown
RHybridDeactivated
SHybridSuspended
THybridAbsent
UHybridActive
aPostpaidUnknown
bPostpaidDeactivated
cPostpaidSuspended
dPostpaidAbsent
ePostpaidActive

Character 2: Account Role & Customer Type

Account Roles

RoleDescription
OwnerFinancially responsible subscriber
ManagerAuthorized account manager
MemberAccount member or line holder
UnknownCarrier did not provide role

Customer Types

TypeDescription
PersonalStandard consumer account
BusinessSmall business account
EmployeeEmployee line on a business account
GovernmentGovernment organization account
WholesaleMVNO or resold carrier block
UnknownCarrier did not provide customer type

Character 2 Mapping

CodeAccount RoleCustomer Type
1UnknownUnknown
2UnknownWholesale
3UnknownPersonal
4UnknownEmployee
5UnknownBusiness
6UnknownGovernment
AMemberUnknown
BMemberWholesale
CMemberPersonal
DMemberEmployee
EMemberBusiness
FMemberGovernment
QManagerUnknown
RManagerWholesale
SManagerPersonal
TManagerEmployee
UManagerBusiness
VManagerGovernment
aOwnerUnknown
bOwnerWholesale
cOwnerPersonal
dOwnerEmployee
eOwnerBusiness
fOwnerGovernment

Example Decoding

Status IndexInterpretation
ecPostpaid, Active account owned by a Personal customer
EBPrepaid, Active account where the user is a Member on a Wholesale account
5aActive account with unknown type, owned by the account holder (customer type unknown)

Notes

  • Not every carrier returns every value shown in this guide.
  • Carrier support varies by network and implementation.
  • Legacy values such as Hybrid and Absent may not be returned by modern carriers.
  • When a value is listed as Unknown, the carrier did not provide that attribute in the response.