Added in API level 1

Summary: Nested Classes | Constants | Fields | Methods | Inherited Methods

TelephonyManager

---

Kotlin |Java

public class TelephonyManager
extends Object

java.lang.Object
↳	android.telephony.TelephonyManager

---

Provides access to information about the telephony services on the device. Applications can use the methods in this class to determine telephony services and states, as well as to access some types of subscriber information. Applications can also register a listener to receive notification of telephony state changes.

The returned TelephonyManager will use the default subscription for all calls. To call an API for a specific subscription, use createForSubscriptionId(int). e.g. telephonyManager = defaultSubTelephonyManager.createForSubscriptionId(subId);

Note that access to some telephony information is permission-protected. Your application cannot access the protected information unless it has the appropriate permissions declared in its manifest file. Where permissions apply, they are noted in the the methods through which you access the protected information.

TelephonyManager is intended for use on devices that implement FEATURE_TELEPHONY. On devices that do not implement this feature, the behavior is not reliable.
Requires the PackageManager#FEATURE_TELEPHONY feature which can be detected using PackageManager.hasSystemFeature(String).

Summary

Nested classes
class	TelephonyManager.CallComposerException Exception that may be supplied to the callback in TelephonyManager.uploadCallComposerPicture(InputStream, String, Executor, OutcomeReceiver) if something goes awry.
class	TelephonyManager.CellInfoCallback Callback for providing asynchronous CellInfo on request
class	TelephonyManager.ModemErrorException Exception that is supplied to the callback in TelephonyManager.getNetworkSlicingConfiguration(Executor, OutcomeReceiver) if the modem returned a failure.
class	TelephonyManager.NetworkSlicingException Exception that may be supplied to the callback in TelephonyManager.getNetworkSlicingConfiguration(Executor, OutcomeReceiver) if something goes awry.
class	TelephonyManager.TimeoutException Exception that is supplied to the callback in TelephonyManager.getNetworkSlicingConfiguration(Executor, OutcomeReceiver) if the system timed out waiting for a response from the Radio.
class	TelephonyManager.UssdResponseCallback Used to notify callers of TelephonyManager.sendUssdRequest(String, UssdResponseCallback, Handler) when the network either successfully executes a USSD request, or if there was a failure while executing the request.

Constants
String	ACTION_CARRIER_MESSAGING_CLIENT_SERVICE A service action that identifies a CarrierMessagingClientService subclass in the AndroidManifest.xml.
String	ACTION_CARRIER_SIGNAL_DEFAULT_NETWORK_AVAILABLE Broadcast action sent when the availability of the system default network changes.
String	ACTION_CARRIER_SIGNAL_PCO_VALUE Broadcast action sent when a PCO value becomes available from the modem.
String	ACTION_CARRIER_SIGNAL_REDIRECTED Broadcast action sent when a data connection is redirected with validation failure.
String	ACTION_CARRIER_SIGNAL_REQUEST_NETWORK_FAILED Broadcast action sent when a data connection setup fails.
String	ACTION_CARRIER_SIGNAL_RESET Broadcast action sent when carrier apps should reset their internal state.
String	ACTION_CONFIGURE_VOICEMAIL Open the voicemail settings activity to make changes to voicemail configuration.
String	ACTION_MULTI_SIM_CONFIG_CHANGED Broadcast action to be received by Broadcast receivers.
String	ACTION_NETWORK_COUNTRY_CHANGED Broadcast intent action for network country code changes.
String	ACTION_PHONE_STATE_CHANGED Broadcast intent action indicating that the call state on the device has changed.
String	ACTION_RESET_MOBILE_NETWORK_SETTINGS Activity action: Show setting to reset mobile networks.
String	ACTION_RESPOND_VIA_MESSAGE The Phone app sends this intent when a user opts to respond-via-message during an incoming call.
String	ACTION_SECRET_CODE Broadcast Action: A debug code has been entered in the dialer.
String	ACTION_SHOW_VOICEMAIL_NOTIFICATION Broadcast intent action for letting the default dialer to know to show voicemail notification.
String	ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED Broadcast Action: The subscription carrier identity has changed.
String	ACTION_SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED Broadcast Action: The subscription specific carrier identity has changed.
int	ALLOWED_NETWORK_TYPES_REASON_CARRIER To indicate allowed network type change is requested by carrier.
int	ALLOWED_NETWORK_TYPES_REASON_USER To indicate allowed network type change is requested by user.
int	APPTYPE_CSIM UICC application type is CSIM
int	APPTYPE_ISIM UICC application type is ISIM
int	APPTYPE_RUIM UICC application type is RUIM
int	APPTYPE_SIM UICC application type is SIM
int	APPTYPE_UNKNOWN UICC application type is unknown or not specified
int	APPTYPE_USIM UICC application type is USIM
int	AUTHTYPE_EAP_AKA Authentication type for UICC challenge is EAP AKA.
int	AUTHTYPE_EAP_SIM Authentication type for UICC challenge is EAP SIM.
int	AUTHTYPE_GBA_BOOTSTRAP Authentication type for GBA Bootstrap Challenge.
int	AUTHTYPE_GBA_NAF_KEY_EXTERNAL Authentication type for GBA Network Application Functions (NAF) key External Challenge.
int	CALL_COMPOSER_STATUS_BUSINESS_ONLY Call composer status Business Only from user setting.
int	CALL_COMPOSER_STATUS_OFF Call composer status OFF from user setting.
int	CALL_COMPOSER_STATUS_ON Call composer status ON from user setting.
int	CALL_STATE_IDLE Device call state: No activity.
int	CALL_STATE_OFFHOOK Device call state: Off-hook.
int	CALL_STATE_RINGING Device call state: Ringing.
String	CAPABILITY_SLICING_CONFIG_SUPPORTED Indicates whether getNetworkSlicingConfiguration(Executor, OutcomeReceiver) is supported.
int	CARRIER_RESTRICTION_STATUS_NOT_RESTRICTED The device is not restricted to a carrier
int	CARRIER_RESTRICTION_STATUS_RESTRICTED The device is restricted to a carrier.
int	CARRIER_RESTRICTION_STATUS_RESTRICTED_TO_CALLER The device is restricted to the carrier of the calling application.
int	CARRIER_RESTRICTION_STATUS_UNKNOWN Carrier restriction status value is unknown, in case modem did not provide any information about carrier restriction status.
int	CDMA_ROAMING_MODE_AFFILIATED Value for CarrierConfigManager.KEY_CDMA_ROAMING_MODE_INT which permits roaming on affiliated networks.
int	CDMA_ROAMING_MODE_ANY Value for CarrierConfigManager.KEY_CDMA_ROAMING_MODE_INT which permits roaming on any network.
int	CDMA_ROAMING_MODE_HOME Value for CarrierConfigManager.KEY_CDMA_ROAMING_MODE_INT which only permits connections on home networks.
int	CDMA_ROAMING_MODE_RADIO_DEFAULT Value for CarrierConfigManager.KEY_CDMA_ROAMING_MODE_INT which leaves the roaming mode set to the radio default or to the user's preference if they've indicated one.
int	DATA_ACTIVITY_DORMANT Data connection is active, but physical link is down
int	DATA_ACTIVITY_IN Data connection activity: Currently receiving IP PPP traffic.
int	DATA_ACTIVITY_INOUT Data connection activity: Currently both sending and receiving IP PPP traffic.
int	DATA_ACTIVITY_NONE Data connection activity: No traffic.
int	DATA_ACTIVITY_OUT Data connection activity: Currently sending IP PPP traffic.
int	DATA_CONNECTED Data connection state: Connected.
int	DATA_CONNECTING Data connection state: Currently setting up a data connection.
int	DATA_DISCONNECTED Data connection state: Disconnected.
int	DATA_DISCONNECTING Data connection state: Disconnecting.
int	DATA_ENABLED_REASON_CARRIER To indicate enable or disable carrier data by the system based on carrier signalling or carrier privileged apps.
int	DATA_ENABLED_REASON_OVERRIDE To indicate data was enabled or disabled due to mobile data policy overrides.
int	DATA_ENABLED_REASON_POLICY To indicate that data control due to policy.
int	DATA_ENABLED_REASON_THERMAL To indicate enable or disable data by thermal service.
int	DATA_ENABLED_REASON_UNKNOWN To indicate that data was enabled or disabled due to an unknown reason.
int	DATA_ENABLED_REASON_USER To indicate that user enabled or disabled data.
int	DATA_HANDOVER_IN_PROGRESS Data connection state: Handover in progress.
int	DATA_SUSPENDED Data connection state: Suspended.
int	DATA_UNKNOWN Data connection state: Unknown.
int	DEFAULT_PORT_INDEX Default port index for a UICC.
int	ERI_FLASH ERI (Enhanced Roaming Indicator) is FLASH i.e value 2 defined by 3GPP2 C.R1001-H v1.0 Table 8.1-1.
int	ERI_OFF ERI (Enhanced Roaming Indicator) is OFF i.e value 1 defined by 3GPP2 C.R1001-H v1.0 Table 8.1-1.
int	ERI_ON ERI (Enhanced Roaming Indicator) is ON i.e value 0 defined by 3GPP2 C.R1001-H v1.0 Table 8.1-1.
String	EVENT_DISPLAY_EMERGENCY_MESSAGE Event reported from the Telephony stack to indicate that the Connection is not able to find any network and likely will not get connected.
String	EXTRA_ACTIVE_SIM_SUPPORTED_COUNT The number of active SIM supported by current multi-SIM config.
String	EXTRA_APN_PROTOCOL An integer extra containing the protocol of the apn connection.
String	EXTRA_APN_TYPE An integer extra containing the APN type.
String	EXTRA_CALL_VOICEMAIL_INTENT The intent to call voicemail.
String	EXTRA_CARRIER_ID An int extra used with ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED which indicates the updated carrier id returned by TelephonyManager.getSimCarrierId().
String	EXTRA_CARRIER_NAME An string extra used with ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED which indicates the updated carrier name of the current subscription.
String	EXTRA_DATA_FAIL_CAUSE An integer extra containing the data fail cause.
String	EXTRA_DEFAULT_NETWORK_AVAILABLE A boolean extra indicating the availability of the default network.
String	EXTRA_EMERGENCY_CALL_TO_SATELLITE_HANDOVER_TYPE Integer extra key used with EVENT_DISPLAY_EMERGENCY_MESSAGE which indicates the type of handover from emergency call to satellite messaging.
String	EXTRA_EMERGENCY_CALL_TO_SATELLITE_LAUNCH_INTENT Extra key used with the EVENT_DISPLAY_EMERGENCY_MESSAGE for a PendingIntent which will be launched by the Dialer app.
String	EXTRA_HIDE_PUBLIC_SETTINGS The boolean value indicating whether the voicemail settings activity launched by ACTION_CONFIGURE_VOICEMAIL should hide settings accessible through public API.
String	EXTRA_INCOMING_NUMBER This constant was deprecated in API level 29. Companion apps for wearable devices should use the InCallService API to retrieve the phone number for calls instead. Apps performing call screening should use the CallScreeningService API instead.
String	EXTRA_IS_REFRESH Boolean value representing whether the ACTION_SHOW_VOICEMAIL_NOTIFICATION is new or a refresh of an existing notification.
String	EXTRA_LAST_KNOWN_NETWORK_COUNTRY The extra used with an ACTION_NETWORK_COUNTRY_CHANGED to specify the last known the country code in ISO-3166-1 alpha-2 format.
String	EXTRA_LAUNCH_VOICEMAIL_SETTINGS_INTENT The intent to launch voicemail settings.
String	EXTRA_NETWORK_COUNTRY The extra used with an ACTION_NETWORK_COUNTRY_CHANGED to specify the the country code in ISO-3166-1 alpha-2 format.
String	EXTRA_NOTIFICATION_COUNT The number of voice messages associated with the notification.
String	EXTRA_PCO_ID An integer extra indicating the ID for the PCO data.
String	EXTRA_PCO_VALUE A byte array extra containing PCO data read from the modem.
String	EXTRA_PHONE_ACCOUNT_HANDLE The extra used with an ACTION_CONFIGURE_VOICEMAIL and ACTION_SHOW_VOICEMAIL_NOTIFICATION Intent to specify the PhoneAccountHandle the configuration or notification is for.
String	EXTRA_REDIRECTION_URL String extra containing the redirection URL sent with ACTION_CARRIER_SIGNAL_REDIRECTED.
String	EXTRA_SPECIFIC_CARRIER_ID An int extra used with ACTION_SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED which indicates the updated specific carrier id returned by TelephonyManager.getSimSpecificCarrierId().
String	EXTRA_SPECIFIC_CARRIER_NAME An string extra used with ACTION_SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED which indicates the updated specific carrier name returned by TelephonyManager.getSimSpecificCarrierIdName().
String	EXTRA_STATE The lookup key used with the ACTION_PHONE_STATE_CHANGED broadcast for a String containing the new call state.
String	EXTRA_SUBSCRIPTION_ID An int extra used with ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED to indicate the subscription which has changed; or in general whenever a subscription ID needs specified.
String	EXTRA_VOICEMAIL_NUMBER The voicemail number.
int	INCLUDE_LOCATION_DATA_COARSE Include coarse location data.
int	INCLUDE_LOCATION_DATA_FINE Include fine location data.
int	INCLUDE_LOCATION_DATA_NONE Specifies to not include any location related data.
String	METADATA_HIDE_VOICEMAIL_SETTINGS_MENU A boolean meta-data value indicating whether the voicemail settings should be hidden in the call settings page launched by TelecomManager.ACTION_SHOW_CALL_SETTINGS.
int	MULTISIM_ALLOWED The usage of multiple SIM cards at the same time to register on the network (e.g. Dual Standby or Dual Active) is supported.
int	MULTISIM_NOT_SUPPORTED_BY_CARRIER The usage of multiple SIM cards at the same time to register on the network (e.g. Dual Standby or Dual Active) is supported by the hardware, but restricted by the carrier.
int	MULTISIM_NOT_SUPPORTED_BY_HARDWARE The usage of multiple SIM cards at the same time to register on the network (e.g. Dual Standby or Dual Active) is not supported by the hardware.
int	NETWORK_SELECTION_MODE_AUTO
int	NETWORK_SELECTION_MODE_MANUAL
int	NETWORK_SELECTION_MODE_UNKNOWN
int	NETWORK_TYPE_1xRTT Current network is 1xRTT
long	NETWORK_TYPE_BITMASK_1xRTT network type bitmask indicating the support of radio tech 1xRTT.
long	NETWORK_TYPE_BITMASK_CDMA network type bitmask indicating the support of radio tech CDMA(IS95A/IS95B).
long	NETWORK_TYPE_BITMASK_EDGE network type bitmask indicating the support of radio tech EDGE.
long	NETWORK_TYPE_BITMASK_EHRPD network type bitmask indicating the support of radio tech EHRPD.
long	NETWORK_TYPE_BITMASK_EVDO_0 network type bitmask indicating the support of radio tech EVDO 0.
long	NETWORK_TYPE_BITMASK_EVDO_A network type bitmask indicating the support of radio tech EVDO A.
long	NETWORK_TYPE_BITMASK_EVDO_B network type bitmask indicating the support of radio tech EVDO B.
long	NETWORK_TYPE_BITMASK_GPRS network type bitmask indicating the support of radio tech GPRS.
long	NETWORK_TYPE_BITMASK_GSM network type bitmask indicating the support of radio tech GSM.
long	NETWORK_TYPE_BITMASK_HSDPA network type bitmask indicating the support of radio tech HSDPA.
long	NETWORK_TYPE_BITMASK_HSPA network type bitmask indicating the support of radio tech HSPA.
long	NETWORK_TYPE_BITMASK_HSPAP network type bitmask indicating the support of radio tech HSPAP.
long	NETWORK_TYPE_BITMASK_HSUPA network type bitmask indicating the support of radio tech HSUPA.
long	NETWORK_TYPE_BITMASK_IWLAN network type bitmask indicating the support of radio tech IWLAN.
long	NETWORK_TYPE_BITMASK_LTE network type bitmask indicating the support of radio tech LTE.
long	NETWORK_TYPE_BITMASK_LTE_CA This constant was deprecated in API level 34. Please use NETWORK_TYPE_BITMASK_LTE instead. Deprecated in Android U.
long	NETWORK_TYPE_BITMASK_NR network type bitmask indicating the support of radio tech NR(New Radio) 5G.
long	NETWORK_TYPE_BITMASK_TD_SCDMA network type bitmask indicating the support of radio tech TD_SCDMA.
long	NETWORK_TYPE_BITMASK_UMTS network type bitmask indicating the support of radio tech UMTS.
long	NETWORK_TYPE_BITMASK_UNKNOWN network type bitmask unknown.
int	NETWORK_TYPE_CDMA Current network is CDMA: Either IS95A or IS95B
int	NETWORK_TYPE_EDGE Current network is EDGE
int	NETWORK_TYPE_EHRPD Current network is eHRPD
int	NETWORK_TYPE_EVDO_0 Current network is EVDO revision 0
int	NETWORK_TYPE_EVDO_A Current network is EVDO revision A
int	NETWORK_TYPE_EVDO_B Current network is EVDO revision B
int	NETWORK_TYPE_GPRS Current network is GPRS
int	NETWORK_TYPE_GSM Current network is GSM
int	NETWORK_TYPE_HSDPA Current network is HSDPA
int	NETWORK_TYPE_HSPA Current network is HSPA
int	NETWORK_TYPE_HSPAP Current network is HSPA+
int	NETWORK_TYPE_HSUPA Current network is HSUPA
int	NETWORK_TYPE_IDEN This constant was deprecated in API level 34. Legacy network type no longer being used starting in Android U.
int	NETWORK_TYPE_IWLAN Current network is IWLAN
int	NETWORK_TYPE_LTE Current network is LTE
int	NETWORK_TYPE_NR Current network is NR (New Radio) 5G.
int	NETWORK_TYPE_TD_SCDMA Current network is TD_SCDMA
int	NETWORK_TYPE_UMTS Current network is UMTS
int	NETWORK_TYPE_UNKNOWN Network type is unknown
int	PHONE_TYPE_CDMA Phone radio is CDMA.
int	PHONE_TYPE_GSM Phone radio is GSM.
int	PHONE_TYPE_NONE No phone radio.
int	PHONE_TYPE_SIP Phone is via SIP.
int	PREMIUM_CAPABILITY_PRIORITIZE_LATENCY A premium capability that boosts the network to allow for real-time interactive traffic by prioritizing low latency communication.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_IN_PROGRESS Purchase premium capability failed because a request was already made and is in progress.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED Purchase premium capability failed because it is already purchased and available.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLED Purchase premium capability failed because the carrier disabled or does not support the capability, as specified in CarrierConfigManager.KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAY.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_ERROR Purchase premium capability failed because the carrier app did not indicate success.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_ENTITLEMENT_CHECK_FAILED Purchase premium capability failed because the entitlement check failed.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_FEATURE_NOT_SUPPORTED Purchase premium capability failed because the device does not support the feature.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE Purchase premium capability failed because the network is not available.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_DEFAULT_DATA_SUBSCRIPTION Purchase premium capability failed because the request was not made on the default data subscription, indicated by SubscriptionManager.getDefaultDataSubscriptionId().
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_FOREGROUND Purchase premium capability failed because the requesting application is not in the foreground.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP Purchase premium capability was successful and is waiting for the network to setup the slicing configuration.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_REQUEST_FAILED Purchase premium capability failed because the telephony service is unavailable or there was an error in the phone process.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS Purchase premium capability request was successful.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED Purchase premium capability failed because the request is throttled.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_TIMEOUT Purchase premium capability failed because we did not receive a response from the user for the performance boost notification within the time specified by CarrierConfigManager.KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_USER_CANCELED Purchase premium capability failed because the user canceled the operation.
int	PURCHASE_PREMIUM_CAPABILITY_RESULT_USER_DISABLED Purchase premium capability failed because the user disabled the feature.
int	SET_OPPORTUNISTIC_SUB_INACTIVE_SUBSCRIPTION The subscription is not valid.
int	SET_OPPORTUNISTIC_SUB_NO_OPPORTUNISTIC_SUB_AVAILABLE The subscription is not valid.
int	SET_OPPORTUNISTIC_SUB_REMOTE_SERVICE_EXCEPTION Subscription service happened remote exception.
int	SET_OPPORTUNISTIC_SUB_SUCCESS No error.
int	SET_OPPORTUNISTIC_SUB_VALIDATION_FAILED Validation failed when trying to switch to preferred subscription.
int	SIM_STATE_ABSENT SIM card state: no SIM card is available in the device
int	SIM_STATE_CARD_IO_ERROR SIM card state: SIM Card Error, present but faulty
int	SIM_STATE_CARD_RESTRICTED SIM card state: SIM Card restricted, present but not usable due to carrier restrictions.
int	SIM_STATE_NETWORK_LOCKED SIM card state: Locked: requires a network PIN to unlock
int	SIM_STATE_NOT_READY SIM card state: SIM Card is NOT READY
int	SIM_STATE_PERM_DISABLED SIM card state: SIM Card Error, permanently disabled
int	SIM_STATE_PIN_REQUIRED SIM card state: Locked: requires the user's SIM PIN to unlock
int	SIM_STATE_PUK_REQUIRED SIM card state: Locked: requires the user's SIM PUK to unlock
int	SIM_STATE_READY SIM card state: Ready
int	SIM_STATE_UNKNOWN SIM card state: Unknown.
int	UNINITIALIZED_CARD_ID A UICC card identifier used before the UICC card is loaded.
int	UNKNOWN_CARRIER_ID An unknown carrier id.
int	UNSUPPORTED_CARD_ID A UICC card identifier used if the device does not support the operation.
int	UPDATE_AVAILABLE_NETWORKS_ABORTED The request is aborted.
int	UPDATE_AVAILABLE_NETWORKS_DISABLE_MODEM_FAIL Disable modem fail.
int	UPDATE_AVAILABLE_NETWORKS_ENABLE_MODEM_FAIL Enable modem fail.
int	UPDATE_AVAILABLE_NETWORKS_INVALID_ARGUMENTS The parameter passed in is invalid.
int	UPDATE_AVAILABLE_NETWORKS_MULTIPLE_NETWORKS_NOT_SUPPORTED Carrier app does not support multiple available networks.
int	UPDATE_AVAILABLE_NETWORKS_NO_CARRIER_PRIVILEGE No carrier privilege.
int	UPDATE_AVAILABLE_NETWORKS_NO_OPPORTUNISTIC_SUB_AVAILABLE The subscription is not valid.
int	UPDATE_AVAILABLE_NETWORKS_REMOTE_SERVICE_EXCEPTION There is no OpportunisticNetworkService.
int	UPDATE_AVAILABLE_NETWORKS_SERVICE_IS_DISABLED OpportunisticNetworkService is disabled.
int	UPDATE_AVAILABLE_NETWORKS_SUCCESS No error.
int	UPDATE_AVAILABLE_NETWORKS_UNKNOWN_FAILURE There is a unknown failure happened.
int	USSD_ERROR_SERVICE_UNAVAIL Failure code returned when a USSD request has failed to execute because the Telephony service is unavailable.
int	USSD_RETURN_FAILURE Failed code returned when the mobile network has failed to complete a USSD request.
String	VVM_TYPE_CVVM A flavor of OMTP protocol with a different mobile originated (MO) format
String	VVM_TYPE_OMTP The OMTP protocol.

Fields
public static final String	EXTRA_STATE_IDLE Value used with EXTRA_STATE corresponding to CALL_STATE_IDLE.
public static final String	EXTRA_STATE_OFFHOOK Value used with EXTRA_STATE corresponding to CALL_STATE_OFFHOOK.
public static final String	EXTRA_STATE_RINGING Value used with EXTRA_STATE corresponding to CALL_STATE_RINGING.

Public methods
boolean	canChangeDtmfToneLength() Whether the device supports configuring the DTMF tone length.
void	clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest request) Clear a SignalStrengthUpdateRequest from the system.
TelephonyManager	createForPhoneAccountHandle(PhoneAccountHandle phoneAccountHandle) Create a new TelephonyManager object pinned to the subscription ID associated with the given phone account.
TelephonyManager	createForSubscriptionId(int subId) Create a new TelephonyManager object pinned to the given subscription ID.
boolean	doesSwitchMultiSimConfigTriggerReboot() Get whether making changes to modem configurations by switchMultiSimConfig(int) will trigger device reboot.
int	getActiveModemCount() Returns the number of logical modems currently configured to be activated.
List<CellInfo>	getAllCellInfo() Requests all available cell information from all radios on the device including the camped/registered, serving, and neighboring cells.
long	getAllowedNetworkTypesForReason(int reason) Get the allowed network types for certain reason.
int	getCallComposerStatus() Get the user-set status for enriched calling with call composer.
int	getCallState() This method was deprecated in API level 31. Use getCallStateForSubscription() to retrieve the call state for a specific telephony subscription (which allows carrier privileged apps), TelephonyCallback.CallStateListener for real-time call state updates, or TelecomManager.isInCall(), which supplies an aggregate "in call" state for the entire device.
int	getCallStateForSubscription() Retrieve the call state for a specific subscription that was specified when this TelephonyManager instance was created.
int	getCardIdForDefaultEuicc() Get the card ID of the default eUICC card.
PersistableBundle	getCarrierConfig() Returns the carrier config of the subscription ID pinned to the TelephonyManager.
int	getCarrierIdFromSimMccMnc() Returns carrier id based on sim MCCMNC (returned by getSimOperator()) only.
void	getCarrierRestrictionStatus(Executor executor, Consumer<Integer> resultListener) Get the carrier restriction status of the device.
CellLocation	getCellLocation() This method was deprecated in API level 26. use getAllCellInfo() instead, which returns a superset of this API.
int	getDataActivity() Returns a constant indicating the type of activity on a data connection (cellular).
int	getDataNetworkType() Returns a constant indicating the radio technology (network type) currently in use on the device for data transmission.
int	getDataState() Returns a constant indicating the current data connection state (cellular).
String	getDeviceId() This method was deprecated in API level 26. Use getImei() which returns IMEI for GSM or getMeid() which returns MEID for CDMA.
String	getDeviceId(int slotIndex) This method was deprecated in API level 26. Use getImei() which returns IMEI for GSM or getMeid() which returns MEID for CDMA.
String	getDeviceSoftwareVersion() Returns the software version number for the device, for example, the IMEI/SV for GSM phones.
Map<Integer, List<EmergencyNumber>>	getEmergencyNumberList() Get the emergency number list based on current locale, sim, default, modem and network.
Map<Integer, List<EmergencyNumber>>	getEmergencyNumberList(int categories) Get the per-category emergency number list based on current locale, sim, default, modem and network.
List<String>	getEquivalentHomePlmns() Returns a list of the equivalent home PLMNs (EF_EHPLMN) from the USIM app.
String[]	getForbiddenPlmns() Returns an array of Forbidden PLMNs from the USIM App Returns null if the query fails.
String	getGroupIdLevel1() Returns the Group Identifier Level1 for a GSM phone.
String	getIccAuthentication(int appType, int authType, String data) Returns the response of authentication for the default subscription.
String	getImei(int slotIndex) Returns the IMEI (International Mobile Equipment Identity).
String	getImei() Returns the IMEI (International Mobile Equipment Identity).
String	getLine1Number() This method was deprecated in API level 33. use SubscriptionManager.getPhoneNumber(int) instead.
String	getManualNetworkSelectionPlmn() Get the PLMN chosen for Manual Network Selection if active.
String	getManufacturerCode(int slotIndex) Returns the Manufacturer Code from the MEID.
String	getManufacturerCode() Returns the Manufacturer Code from the MEID.
static long	getMaximumCallComposerPictureSize() Indicates the maximum size of the call composure picture.
String	getMeid() Returns the MEID (Mobile Equipment Identifier).
String	getMeid(int slotIndex) Returns the MEID (Mobile Equipment Identifier).
String	getMmsUAProfUrl() Returns the MMS user agent profile URL.
String	getMmsUserAgent() Returns the MMS user agent.
String	getNai() Returns the Network Access Identifier (NAI).
String	getNetworkCountryIso() Returns the ISO-3166-1 alpha-2 country code equivalent of the MCC (Mobile Country Code) of the current registered operator or the cell nearby, if available.
String	getNetworkCountryIso(int slotIndex) Returns the ISO-3166-1 alpha-2 country code equivalent of the MCC (Mobile Country Code) of the current registered operator or the cell nearby, if available.
String	getNetworkOperator() Returns the numeric name (MCC+MNC) of current registered operator.
String	getNetworkOperatorName() Returns the alphabetic name of current registered operator.
int	getNetworkSelectionMode() Get the network selection mode.
void	getNetworkSlicingConfiguration(Executor executor, OutcomeReceiver<NetworkSlicingConfig, TelephonyManager.NetworkSlicingException> callback) Request to get the current slicing configuration including URSP rules and NSSAIs (configured, allowed and rejected).
String	getNetworkSpecifier() Returns the network specifier of the subscription ID pinned to the TelephonyManager.
int	getNetworkType() This method was deprecated in API level 30. use getDataNetworkType()
PhoneAccountHandle	getPhoneAccountHandle() Determines the PhoneAccountHandle associated with this TelephonyManager.
int	getPhoneCount() This method was deprecated in API level 30. Use getActiveModemCount() instead.
int	getPhoneType() Returns a constant indicating the device phone type.
int	getPreferredOpportunisticDataSubscription() Get preferred opportunistic data subscription Id Requires that the calling app has carrier privileges (see hasCarrierPrivileges()), or has either READ_PRIVILEGED_PHONE_STATE or READ_PHONE_STATE permission.
String	getPrimaryImei() Returns the primary IMEI (International Mobile Equipment Identity) of the device as mentioned in GSMA TS.37.
ServiceState	getServiceState(int includeLocationData) Returns the current ServiceState information.
ServiceState	getServiceState() Returns the current ServiceState information.
SignalStrength	getSignalStrength() Get the most recently available signal strength information.
int	getSimCarrierId() Returns carrier id of the current subscription.
CharSequence	getSimCarrierIdName() Returns carrier id name of the current subscription.
String	getSimCountryIso() Returns the ISO-3166-1 alpha-2 country code equivalent for the SIM provider's country code.
String	getSimOperator() Returns the MCC+MNC (mobile country code + mobile network code) of the provider of the SIM.
String	getSimOperatorName() Returns the Service Provider Name (SPN).
String	getSimSerialNumber() Returns the serial number of the SIM, if applicable.
int	getSimSpecificCarrierId() Returns fine-grained carrier ID of the current subscription.
CharSequence	getSimSpecificCarrierIdName() Similar like getSimCarrierIdName(), returns user-facing name of the specific carrier id returned by getSimSpecificCarrierId().
int	getSimState() Returns a constant indicating the state of the default SIM card.
int	getSimState(int slotIndex) Returns a constant indicating the state of the device SIM card in a logical slot.
String	getSubscriberId() Returns the unique subscriber ID, for example, the IMSI for a GSM phone.
int	getSubscriptionId(PhoneAccountHandle phoneAccountHandle) Returns the subscription ID for the given phone account handle.
int	getSubscriptionId() Return an appropriate subscription ID for any situation.
int	getSupportedModemCount() Return how many logical modem can be potentially active simultaneously, in terms of hardware capability.
long	getSupportedRadioAccessFamily() Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).
String	getTypeAllocationCode() Returns the Type Allocation Code from the IMEI.
String	getTypeAllocationCode(int slotIndex) Returns the Type Allocation Code from the IMEI.
List<UiccCardInfo>	getUiccCardsInfo() Gets information about currently inserted UICCs and eUICCs.
String	getVisualVoicemailPackageName() Returns the package responsible of processing visual voicemail for the subscription ID pinned to the TelephonyManager.
String	getVoiceMailAlphaTag() Retrieves the alphabetic identifier associated with the voice mail number.
String	getVoiceMailNumber() Returns the voice mail number.
int	getVoiceNetworkType() Returns the NETWORK_TYPE_xxxx for voice Requires Permission: READ_PHONE_STATE or READ_BASIC_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Uri	getVoicemailRingtoneUri(PhoneAccountHandle accountHandle) Returns the URI for the per-account voicemail ringtone set in Phone settings.
boolean	hasCarrierPrivileges() Has the calling application been granted carrier privileges by the carrier.
boolean	hasIccCard() This API is used to check if there is an ICC card present in the device.
boolean	iccCloseLogicalChannel(int channel) Closes a previously opened logical channel to the ICC card.
byte[]	iccExchangeSimIO(int fileID, int command, int p1, int p2, int p3, String filePath) Returns the response APDU for a command APDU sent through SIM_IO.
IccOpenLogicalChannelResponse	iccOpenLogicalChannel(String AID, int p2) Opens a logical channel to the ICC card.
IccOpenLogicalChannelResponse	iccOpenLogicalChannel(String AID) This method was deprecated in API level 26. Replaced by iccOpenLogicalChannel(java.lang.String, int)
String	iccTransmitApduBasicChannel(int cla, int instruction, int p1, int p2, int p3, String data) Transmit an APDU to the ICC card over the basic channel.
String	iccTransmitApduLogicalChannel(int channel, int cla, int instruction, int p1, int p2, int p3, String data) Transmit an APDU to the ICC card over a logical channel.
boolean	isConcurrentVoiceAndDataSupported() Whether the device is currently on a technology (e.g. UMTS or LTE) which can support voice and data simultaneously.
boolean	isDataCapable()
boolean	isDataConnectionAllowed() Checks whether cellular data connection is allowed in the device.
boolean	isDataEnabled() Returns whether mobile data is enabled or not per user setting.
boolean	isDataEnabledForReason(int reason) Return whether data is enabled for certain reason .
boolean	isDataRoamingEnabled() Returns whether mobile data roaming is enabled on the subscription.
boolean	isDeviceSmsCapable()
boolean	isDeviceVoiceCapable()
boolean	isEmergencyNumber(String number) Identifies if the supplied phone number is an emergency number that matches a known emergency number based on current locale, SIM card(s), Android database, modem, network, or defaults.
boolean	isHearingAidCompatibilitySupported() Whether the phone supports hearing aid compatibility.
boolean	isManualNetworkSelectionAllowed() Checks if manual network selection is allowed.
boolean	isModemEnabledForSlot(int slotIndex) Indicates whether or not there is a modem stack enabled for the given SIM slot.
int	isMultiSimSupported() Returns if the usage of multiple SIM cards at the same time to register on the network (e.g. Dual Standby or Dual Active) is supported by the device and by the carrier.
boolean	isNetworkRoaming() Returns true if the device is considered roaming on the current network, for GSM purposes.
boolean	isPremiumCapabilityAvailableForPurchase(int capability) Check whether the given premium capability is available for purchase from the carrier.
boolean	isRadioInterfaceCapabilitySupported(String capability) Whether the device supports a given capability on the radio interface.
boolean	isRttSupported() Determines whether the device currently supports RTT (Real-time text).
boolean	isSmsCapable() This method was deprecated in API level 35. Replaced by isDeviceSmsCapable(). Starting from Android 15, SMS capability may also be overridden by carriers for a given subscription. For SMS capable device (when isDeviceSmsCapable() return true), caller should check for subscription-level SMS capability as well. See isDeviceSmsCapable() for details.
boolean	isTtyModeSupported() This method was deprecated in API level 28. Use TelecomManager.isTtySupported() instead Whether the phone supports TTY mode.
boolean	isVoiceCapable() This method was deprecated in API level 35. Replaced by isDeviceVoiceCapable(). Starting from Android 15, voice capability may also be overridden by carriers for a given subscription. For voice capable device (when isDeviceVoiceCapable() return true), caller should check for subscription-level voice capability as well. See isDeviceVoiceCapable() for details.
boolean	isVoicemailVibrationEnabled(PhoneAccountHandle accountHandle) Returns whether vibration is set for voicemail notification in Phone settings.
boolean	isWorldPhone() Whether the device is a world phone.
void	listen(PhoneStateListener listener, int events) This method was deprecated in API level 31. Use registerTelephonyCallback(java.util.concurrent.Executor, android.telephony.TelephonyCallback).
void	purchasePremiumCapability(int capability, Executor executor, Consumer<Integer> callback) Purchase the given premium capability from the carrier.
void	rebootModem() Generate a radio modem reset.
void	registerTelephonyCallback(Executor executor, TelephonyCallback callback) Registers a callback object to receive notification of changes in specified telephony states.
void	registerTelephonyCallback(int includeLocationData, Executor executor, TelephonyCallback callback) Registers a callback object to receive notification of changes in specified telephony states.
void	requestCellInfoUpdate(Executor executor, TelephonyManager.CellInfoCallback callback) Requests all available cell information from the current subscription for observed camped/registered, serving, and neighboring cells.
NetworkScan	requestNetworkScan(NetworkScanRequest request, Executor executor, TelephonyScanManager.NetworkScanCallback callback) Request a network scan.
NetworkScan	requestNetworkScan(int includeLocationData, NetworkScanRequest request, Executor executor, TelephonyScanManager.NetworkScanCallback callback) Request a network scan.
void	sendDialerSpecialCode(String inputCode) Send the special dialer code.
String	sendEnvelopeWithStatus(String content) Send ENVELOPE to the SIM and return the response.
void	sendUssdRequest(String ussdRequest, TelephonyManager.UssdResponseCallback callback, Handler handler) Sends an Unstructured Supplementary Service Data (USSD) request to the mobile network and informs the caller of the response via the supplied callback.
void	sendVisualVoicemailSms(String number, int port, String text, PendingIntent sentIntent) Send a visual voicemail SMS.
void	setAllowedNetworkTypesForReason(int reason, long allowedNetworkTypes) Set the allowed network types of the device and provide the reason triggering the allowed network change.
void	setCallComposerStatus(int status) Set the user-set status for enriched calling with call composer.
void	setDataEnabled(boolean enable) This method was deprecated in API level 31. use setDataEnabledForReason with reason DATA_ENABLED_REASON_USER instead.
void	setDataEnabledForReason(int reason, boolean enabled) Control of data connection and provide the reason triggering the data connection control.
int	setForbiddenPlmns(List<String> fplmns) Replace the contents of the forbidden PLMN SIM file with the provided values.
boolean	setLine1NumberForDisplay(String alphaTag, String number) This method was deprecated in API level 33. use SubscriptionManager.setCarrierPhoneNumber(int, String) instead.
void	setNetworkSelectionModeAutomatic() Sets the network selection mode to automatic.
boolean	setNetworkSelectionModeManual(String operatorNumeric, boolean persistSelection, int ran) Ask the radio to connect to the input network and change selection mode to manual.
boolean	setNetworkSelectionModeManual(String operatorNumeric, boolean persistSelection) Ask the radio to connect to the input network and change selection mode to manual.
boolean	setOperatorBrandOverride(String brand) Override the branding for the current ICCID.
boolean	setPreferredNetworkTypeToGlobal() Set the preferred network type to global mode which includes NR, LTE, CDMA, EvDo and GSM/WCDMA.
void	setPreferredOpportunisticDataSubscription(int subId, boolean needValidation, Executor executor, Consumer<Integer> callback) Set preferred opportunistic data subscription id.
void	setSignalStrengthUpdateRequest(SignalStrengthUpdateRequest request) Set a SignalStrengthUpdateRequest to receive notification when signal quality measurements breach the specified thresholds.
void	setVisualVoicemailSmsFilterSettings(VisualVoicemailSmsFilterSettings settings) Set the visual voicemail SMS filter settings for the subscription ID pinned to the TelephonyManager.
boolean	setVoiceMailNumber(String alphaTag, String number) Sets the voice mail number.
void	setVoicemailRingtoneUri(PhoneAccountHandle phoneAccountHandle, Uri uri) This method was deprecated in API level 28. Use Settings.ACTION_CHANNEL_NOTIFICATION_SETTINGS instead.
void	setVoicemailVibrationEnabled(PhoneAccountHandle phoneAccountHandle, boolean enabled) This method was deprecated in API level 28. Use Settings.ACTION_CHANNEL_NOTIFICATION_SETTINGS instead.
void	switchMultiSimConfig(int numOfSims) Switch configs to enable multi-sim or switch back to single-sim Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
void	unregisterTelephonyCallback(TelephonyCallback callback) Unregister an existing TelephonyCallback.
void	updateAvailableNetworks(List<AvailableNetworkInfo> availableNetworks, Executor executor, Consumer<Integer> callback) Update availability of a list of networks in the current location.
void	uploadCallComposerPicture(InputStream pictureToUpload, String contentType, Executor executor, OutcomeReceiver<ParcelUuid, TelephonyManager.CallComposerException> callback) Uploads a picture to the carrier network for use with call composer.
void	uploadCallComposerPicture(Path pictureToUpload, String contentType, Executor executor, OutcomeReceiver<ParcelUuid, TelephonyManager.CallComposerException> callback) Uploads a picture to the carrier network for use with call composer.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

ACTION_CARRIER_MESSAGING_CLIENT_SERVICE

Added in API level 29

public static final String ACTION_CARRIER_MESSAGING_CLIENT_SERVICE

A service action that identifies a CarrierMessagingClientService subclass in the AndroidManifest.xml.

See CarrierMessagingClientService for the details.

Constant Value: "android.telephony.action.CARRIER_MESSAGING_CLIENT_SERVICE"

ACTION_CARRIER_SIGNAL_DEFAULT_NETWORK_AVAILABLE

Added in API level 31

public static final String ACTION_CARRIER_SIGNAL_DEFAULT_NETWORK_AVAILABLE

Broadcast action sent when the availability of the system default network changes.

See also:

• This action is intended for carrier apps to set/reset carrier actions. It is only sent to the carrier apps specified in the carrier config for the subscription ID attached to this intent. The intent will have the following extra values:
  • {@link #EXTRA_DEFAULT_NETWORK_AVAILABLE}
  {@code true} if the default network is now available, {@code false} otherwise.
  • {@link android.telephony.SubscriptionManager#EXTRA_SUBSCRIPTION_INDEX SubscriptionManager.EXTRA_SUBSCRIPTION_INDEX}
  The subscription ID on which the default network availability changed.

  This is a protected intent that can only be sent by the system.

Constant Value: "android.telephony.action.CARRIER_SIGNAL_DEFAULT_NETWORK_AVAILABLE"

ACTION_CARRIER_SIGNAL_PCO_VALUE

Added in API level 31

public static final String ACTION_CARRIER_SIGNAL_PCO_VALUE

Broadcast action sent when a PCO value becomes available from the modem. This action is intended for sim/account status checks and only sent to the carrier apps specified in the carrier config for the subscription ID that's attached to this intent. The intent will have the following extra values:

• EXTRA_APN_TYPE
An integer indicating the apn type.
• EXTRA_APN_PROTOCOL
An integer indicating the protocol of the apn connection
• EXTRA_PCO_ID
An integer indicating the PCO id for the data.
• EXTRA_PCO_VALUE
A byte array of PCO data read from modem.
• SubscriptionManager.EXTRA_SUBSCRIPTION_INDEX
The subscription ID for which the PCO info was received.

This is a protected intent that can only be sent by the system.

Constant Value: "android.telephony.action.CARRIER_SIGNAL_PCO_VALUE"

ACTION_CARRIER_SIGNAL_REDIRECTED

Added in API level 31

public static final String ACTION_CARRIER_SIGNAL_REDIRECTED

Broadcast action sent when a data connection is redirected with validation failure. This action is intended for sim/account status checks and only sent to the carrier apps specified in the carrier config for the subscription ID that's attached to this intent. The intent will have the following extra values:

• EXTRA_APN_TYPE
An integer indicating the apn type.
• EXTRA_REDIRECTION_URL
A string indicating the redirection url
• SubscriptionManager.EXTRA_SUBSCRIPTION_INDEX
The subscription ID on which the validation failure happened.

This is a protected intent that can only be sent by the system.

Constant Value: "android.telephony.action.CARRIER_SIGNAL_REDIRECTED"

ACTION_CARRIER_SIGNAL_REQUEST_NETWORK_FAILED

Added in API level 31

public static final String ACTION_CARRIER_SIGNAL_REQUEST_NETWORK_FAILED

Broadcast action sent when a data connection setup fails. This action is intended for sim/account status checks and only sent to the carrier apps specified in the carrier config for the subscription ID that's attached to this intent. The intent will have the following extra values:

• EXTRA_APN_TYPE
An integer indicating the apn type.
• EXTRA_DATA_FAIL_CAUSE
A integer indicating the data fail cause.
• SubscriptionManager.EXTRA_SUBSCRIPTION_INDEX
The subscription ID on which the data setup failure happened.

This is a protected intent that can only be sent by the system.

Constant Value: "android.telephony.action.CARRIER_SIGNAL_REQUEST_NETWORK_FAILED"

ACTION_CARRIER_SIGNAL_RESET

Added in API level 31

public static final String ACTION_CARRIER_SIGNAL_RESET

Broadcast action sent when carrier apps should reset their internal state. Sent when certain events such as turning on/off mobile data, removing the SIM, etc. require carrier apps to reset their state. This action is intended to signal carrier apps to perform cleanup operations. It is only sent to the carrier apps specified in the carrier config for the subscription ID attached to this intent. The intent will have the following extra values:

• SubscriptionManager.EXTRA_SUBSCRIPTION_INDEX
The subscription ID for which state should be reset.

This is a protected intent that can only be sent by the system.

Constant Value: "android.telephony.action.CARRIER_SIGNAL_RESET"

ACTION_CONFIGURE_VOICEMAIL

Added in API level 23

public static final String ACTION_CONFIGURE_VOICEMAIL

Open the voicemail settings activity to make changes to voicemail configuration.

The EXTRA_PHONE_ACCOUNT_HANDLE extra indicates which PhoneAccountHandle to configure voicemail. The EXTRA_HIDE_PUBLIC_SETTINGS hides settings the dialer will modify through public API if set.

See also:

• EXTRA_PHONE_ACCOUNT_HANDLE
• EXTRA_HIDE_PUBLIC_SETTINGS

Constant Value: "android.telephony.action.CONFIGURE_VOICEMAIL"

ACTION_MULTI_SIM_CONFIG_CHANGED

Added in API level 30

public static final String ACTION_MULTI_SIM_CONFIG_CHANGED

Broadcast action to be received by Broadcast receivers. Indicates multi-SIM configuration is changed. For example, it changed from single SIM capable to dual-SIM capable (DSDS or DSDA) or triple-SIM mode. It doesn't indicate how many subscriptions are actually active, or which states SIMs are, or that all steps during multi-SIM change are done. To know those information you still need to listen to SIM_STATE changes or active subscription changes. See extra of EXTRA_ACTIVE_SIM_SUPPORTED_COUNT for updated value.

Constant Value: "android.telephony.action.MULTI_SIM_CONFIG_CHANGED"

ACTION_NETWORK_COUNTRY_CHANGED

Added in API level 29

public static final String ACTION_NETWORK_COUNTRY_CHANGED

Broadcast intent action for network country code changes.

The EXTRA_NETWORK_COUNTRY extra indicates the country code of the current network returned by getNetworkCountryIso().

There may be a delay of several minutes before reporting that no country is detected.

See also:

• EXTRA_NETWORK_COUNTRY
• getNetworkCountryIso()

Constant Value: "android.telephony.action.NETWORK_COUNTRY_CHANGED"

ACTION_PHONE_STATE_CHANGED

Added in API level 3

public static final String ACTION_PHONE_STATE_CHANGED

Broadcast intent action indicating that the call state on the device has changed.

The EXTRA_STATE extra indicates the new call state. If a receiving app has Manifest.permission.READ_CALL_LOG permission, a second extra EXTRA_INCOMING_NUMBER provides the phone number for incoming and outgoing calls as a String.

If the receiving app has Manifest.permission.READ_CALL_LOG and Manifest.permission.READ_PHONE_STATE permission, it will receive the broadcast twice; one with the EXTRA_INCOMING_NUMBER populated with the phone number, and another with it blank. Due to the nature of broadcasts, you cannot assume the order in which these broadcasts will arrive, however you are guaranteed to receive two in this case. Apps which are interested in the EXTRA_INCOMING_NUMBER can ignore the broadcasts where EXTRA_INCOMING_NUMBER is not present in the extras (e.g. where Intent.hasExtra(String) returns false).

This was a sticky broadcast in version 1.0, but it is no longer sticky. Instead, use getCallState() to synchronously query the current call state.
Requires Manifest.permission.READ_PHONE_STATE

See also:

• EXTRA_STATE
• EXTRA_INCOMING_NUMBER
• getCallState()

Constant Value: "android.intent.action.PHONE_STATE"

ACTION_RESET_MOBILE_NETWORK_SETTINGS

Added in API level 35

public static final String ACTION_RESET_MOBILE_NETWORK_SETTINGS

Activity action: Show setting to reset mobile networks.

On devices with a settings activity to reset mobile networks, the activity should be launched without additional permissions.

On some devices, this settings activity may not exist. Callers should ensure that this case is appropriately handled.

Constant Value: "android.telephony.action.RESET_MOBILE_NETWORK_SETTINGS"

ACTION_RESPOND_VIA_MESSAGE

Added in API level 18

public static final String ACTION_RESPOND_VIA_MESSAGE

The Phone app sends this intent when a user opts to respond-via-message during an incoming call. By default, the device's default SMS app consumes this message and sends a text message to the caller. A third party app can also provide this functionality by consuming this Intent with a Service and sending the message using its own messaging system.

The intent contains a URI (available from Intent.getData()) describing the recipient, using either the sms:, smsto:, mms:, or mmsto: URI schema. Each of these URI schema carry the recipient information the same way: the path part of the URI contains the recipient's phone number or a comma-separated set of phone numbers if there are multiple recipients. For example, smsto:2065551234.

The intent may also contain extras for the message text (in Intent.EXTRA_TEXT) and a message subject (in Intent.EXTRA_SUBJECT).

Note: The intent-filter that consumes this Intent needs to be in a Service that requires the permission Manifest.permission.SEND_RESPOND_VIA_MESSAGE.

For example, the service that receives this intent can be declared in the manifest file with an intent filter like this:

 <!-- Service that delivers SMS messages received from the phone "quick response" -->
 <service android:name=".HeadlessSmsSendService"
          android:permission="android.permission.SEND_RESPOND_VIA_MESSAGE"
          android:exported="true" >
   <intent-filter>
     <action android:name="android.intent.action.RESPOND_VIA_MESSAGE" />
     <category android:name="android.intent.category.DEFAULT" />
     <data android:scheme="sms" />
     <data android:scheme="smsto" />
     <data android:scheme="mms" />
     <data android:scheme="mmsto" />
   </intent-filter>
 </service>

Output: nothing.

Constant Value: "android.intent.action.RESPOND_VIA_MESSAGE"

ACTION_SECRET_CODE

Added in API level 29

public static final String ACTION_SECRET_CODE

Broadcast Action: A debug code has been entered in the dialer.

This intent is broadcast by the system and OEM telephony apps may need to receive these broadcasts. And it requires the sender to be default dialer or has carrier privileges (see hasCarrierPrivileges()).

These "secret codes" are used to activate developer menus by dialing certain codes. And they are of the form *#*#<code>#*#*. The intent will have the data URI: android_secret_code://<code>. It is possible that a manifest receiver would be woken up even if it is not currently running.

It is supposed to replace Telephony.Sms.Intents.SECRET_CODE_ACTION in the next Android version. Before that both of these two actions will be broadcast.

Constant Value: "android.telephony.action.SECRET_CODE"

ACTION_SHOW_VOICEMAIL_NOTIFICATION

Added in API level 26

public static final String ACTION_SHOW_VOICEMAIL_NOTIFICATION

Broadcast intent action for letting the default dialer to know to show voicemail notification.

The EXTRA_PHONE_ACCOUNT_HANDLE extra indicates which PhoneAccountHandle the voicemail is received on. The EXTRA_NOTIFICATION_COUNT extra indicates the total numbers of unheard voicemails. The EXTRA_VOICEMAIL_NUMBER extra indicates the voicemail number if available. The EXTRA_CALL_VOICEMAIL_INTENT extra is a PendingIntent that will call the voicemail number when sent. This extra will be empty if the voicemail number is not set, and EXTRA_LAUNCH_VOICEMAIL_SETTINGS_INTENT will be set instead. The EXTRA_LAUNCH_VOICEMAIL_SETTINGS_INTENT extra is a PendingIntent that will launch the voicemail settings. This extra is only available when the voicemail number is not set. The EXTRA_IS_REFRESH extra indicates whether the notification is a refresh or a new notification.

See also:

• EXTRA_PHONE_ACCOUNT_HANDLE
• EXTRA_NOTIFICATION_COUNT
• EXTRA_VOICEMAIL_NUMBER
• EXTRA_CALL_VOICEMAIL_INTENT
• EXTRA_LAUNCH_VOICEMAIL_SETTINGS_INTENT
• EXTRA_IS_REFRESH

Constant Value: "android.telephony.action.SHOW_VOICEMAIL_NOTIFICATION"

ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED

Added in API level 28

public static final String ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED

Broadcast Action: The subscription carrier identity has changed. This intent could be sent on the following events:

• Subscription absent. Carrier identity could change from a valid id to TelephonyManager.UNKNOWN_CARRIER_ID.
• Subscription loaded. Carrier identity could change from TelephonyManager.UNKNOWN_CARRIER_ID to a valid id.
• The subscription carrier is recognized after a remote update.

The intent will have the following extra values:

• EXTRA_CARRIER_ID The up-to-date carrier id of the current subscription id.
• EXTRA_CARRIER_NAME The up-to-date carrier name of the current subscription.
• EXTRA_SUBSCRIPTION_ID The subscription id associated with the changed carrier identity.

This is a protected intent that can only be sent by the system.

Constant Value: "android.telephony.action.SUBSCRIPTION_CARRIER_IDENTITY_CHANGED"

ACTION_SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED

Added in API level 29

public static final String ACTION_SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED

Broadcast Action: The subscription specific carrier identity has changed. A specific carrier ID returns the fine-grained carrier ID of the current subscription. It can represent the fact that a carrier may be in effect an aggregation of other carriers (ie in an MVNO type scenario) where each of these specific carriers which are used to make up the actual carrier service may have different carrier configurations. A specific carrier ID could also be used, for example, in a scenario where a carrier requires different carrier configuration for different service offering such as a prepaid plan. the specific carrier ID would be used for configuration purposes, but apps wishing to know about the carrier itself should use the regular carrier ID returned by getSimCarrierId().

Similar like ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED, this intent will be sent on the event of ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED while its also possible to be sent without ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED when specific carrier ID changes while carrier ID remains the same. e.g, the same subscription switches to different IMSI could potentially change its specific carrier ID while carrier id remains the same.

See also:

• getSimSpecificCarrierId()
• The intent will have the following extra values:
  • {@link #EXTRA_SPECIFIC_CARRIER_ID} The up-to-date specific carrier id of the current subscription.
  • {@link #EXTRA_SPECIFIC_CARRIER_NAME} The up-to-date name of the specific carrier id.
  • {@link #EXTRA_SUBSCRIPTION_ID} The subscription id associated with the changed carrier identity.

  This is a protected intent that can only be sent by the system.

Constant Value: "android.telephony.action.SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED"

ALLOWED_NETWORK_TYPES_REASON_CARRIER

Added in API level 33

public static final int ALLOWED_NETWORK_TYPES_REASON_CARRIER

To indicate allowed network type change is requested by carrier. Carrier configuration won't affect the settings configured through other reasons and will result in allowing network types that are in both configurations (i.e intersection of both sets).

Constant Value: 2 (0x00000002)

ALLOWED_NETWORK_TYPES_REASON_USER

Added in API level 33

public static final int ALLOWED_NETWORK_TYPES_REASON_USER

To indicate allowed network type change is requested by user.

Constant Value: 0 (0x00000000)

APPTYPE_CSIM

Added in API level 24

public static final int APPTYPE_CSIM

UICC application type is CSIM

Constant Value: 4 (0x00000004)

APPTYPE_ISIM

Added in API level 24

public static final int APPTYPE_ISIM

UICC application type is ISIM

Constant Value: 5 (0x00000005)

APPTYPE_RUIM

Added in API level 24

public static final int APPTYPE_RUIM

UICC application type is RUIM

Constant Value: 3 (0x00000003)

APPTYPE_SIM

Added in API level 24

public static final int APPTYPE_SIM

UICC application type is SIM

Constant Value: 1 (0x00000001)

APPTYPE_UNKNOWN

Added in API level 31

public static final int APPTYPE_UNKNOWN

UICC application type is unknown or not specified

Constant Value: 0 (0x00000000)

APPTYPE_USIM

Added in API level 24

public static final int APPTYPE_USIM

UICC application type is USIM

Constant Value: 2 (0x00000002)

AUTHTYPE_EAP_AKA

Added in API level 24

public static final int AUTHTYPE_EAP_AKA

Authentication type for UICC challenge is EAP AKA. See RFC 4187 for details.

Constant Value: 129 (0x00000081)

AUTHTYPE_EAP_SIM

Added in API level 24

public static final int AUTHTYPE_EAP_SIM

Authentication type for UICC challenge is EAP SIM. See RFC 4186 for details.

Constant Value: 128 (0x00000080)

AUTHTYPE_GBA_BOOTSTRAP

Added in API level 34

public static final int AUTHTYPE_GBA_BOOTSTRAP

Authentication type for GBA Bootstrap Challenge. Pass this authentication type into the getIccAuthentication(int, int, String) API to perform a GBA Bootstrap challenge (BSF), with data (generated according to the procedure defined in 3GPP 33.220 Section 5.3.2 step.4) in base64 encoding. This method will return the Bootstrapping response in base64 encoding when ICC authentication is completed. Ref 3GPP 33.220 Section 5.3.2.

Constant Value: 132 (0x00000084)

AUTHTYPE_GBA_NAF_KEY_EXTERNAL

Added in API level 34

public static final int AUTHTYPE_GBA_NAF_KEY_EXTERNAL

Authentication type for GBA Network Application Functions (NAF) key External Challenge. Pass this authentication type into the getIccAuthentication(int, int, String) API to perform a GBA Network Applications Functions (NAF) key External challenge using the NAF_ID parameter as the data in base64 encoding. This method will return the Ks_Ext_Naf key in base64 encoding when ICC authentication is completed. Ref 3GPP 33.220 Section 5.3.2.

Constant Value: 133 (0x00000085)

CALL_COMPOSER_STATUS_BUSINESS_ONLY

Added in API level 35

public static final int CALL_COMPOSER_STATUS_BUSINESS_ONLY

Call composer status Business Only from user setting.

Constant Value: 2 (0x00000002)

CALL_COMPOSER_STATUS_OFF

Added in API level 31

public static final int CALL_COMPOSER_STATUS_OFF

Call composer status OFF from user setting.

Constant Value: 0 (0x00000000)

CALL_COMPOSER_STATUS_ON

Added in API level 31

public static final int CALL_COMPOSER_STATUS_ON

Call composer status ON from user setting.

Constant Value: 1 (0x00000001)

CALL_STATE_IDLE

Added in API level 1

public static final int CALL_STATE_IDLE

Device call state: No activity.

Constant Value: 0 (0x00000000)

CALL_STATE_OFFHOOK

Added in API level 1

public static final int CALL_STATE_OFFHOOK

Device call state: Off-hook. At least one call exists that is dialing, active, or on hold, and no calls are ringing or waiting.

Constant Value: 2 (0x00000002)

CALL_STATE_RINGING

Added in API level 1

public static final int CALL_STATE_RINGING

Device call state: Ringing. A new call arrived and is ringing or waiting. In the latter case, another call is already active.

Constant Value: 1 (0x00000001)

CAPABILITY_SLICING_CONFIG_SUPPORTED

Added in API level 31

public static final String CAPABILITY_SLICING_CONFIG_SUPPORTED

Indicates whether getNetworkSlicingConfiguration(Executor, OutcomeReceiver) is supported. See comments on respective methods for more information.

Constant Value: "CAPABILITY_SLICING_CONFIG_SUPPORTED"

CARRIER_RESTRICTION_STATUS_NOT_RESTRICTED

Added in API level 34

public static final int CARRIER_RESTRICTION_STATUS_NOT_RESTRICTED

The device is not restricted to a carrier

Constant Value: 1 (0x00000001)

CARRIER_RESTRICTION_STATUS_RESTRICTED

Added in API level 34

public static final int CARRIER_RESTRICTION_STATUS_RESTRICTED

The device is restricted to a carrier.

Constant Value: 2 (0x00000002)

CARRIER_RESTRICTION_STATUS_RESTRICTED_TO_CALLER

Added in API level 34

public static final int CARRIER_RESTRICTION_STATUS_RESTRICTED_TO_CALLER

The device is restricted to the carrier of the calling application.

Constant Value: 3 (0x00000003)

CARRIER_RESTRICTION_STATUS_UNKNOWN

Added in API level 34

public static final int CARRIER_RESTRICTION_STATUS_UNKNOWN

Carrier restriction status value is unknown, in case modem did not provide any information about carrier restriction status.

Constant Value: 0 (0x00000000)

CDMA_ROAMING_MODE_AFFILIATED

Added in API level 28

public static final int CDMA_ROAMING_MODE_AFFILIATED

Value for CarrierConfigManager.KEY_CDMA_ROAMING_MODE_INT which permits roaming on affiliated networks.

Constant Value: 1 (0x00000001)

CDMA_ROAMING_MODE_ANY

Added in API level 28

public static final int CDMA_ROAMING_MODE_ANY

Value for CarrierConfigManager.KEY_CDMA_ROAMING_MODE_INT which permits roaming on any network.

Constant Value: 2 (0x00000002)

CDMA_ROAMING_MODE_HOME

Added in API level 28

public static final int CDMA_ROAMING_MODE_HOME

Value for CarrierConfigManager.KEY_CDMA_ROAMING_MODE_INT which only permits connections on home networks.

Constant Value: 0 (0x00000000)

CDMA_ROAMING_MODE_RADIO_DEFAULT

Added in API level 28

public static final int CDMA_ROAMING_MODE_RADIO_DEFAULT

Value for CarrierConfigManager.KEY_CDMA_ROAMING_MODE_INT which leaves the roaming mode set to the radio default or to the user's preference if they've indicated one.

Constant Value: -1 (0xffffffff)

DATA_ACTIVITY_DORMANT

Added in API level 4

public static final int DATA_ACTIVITY_DORMANT

Data connection is active, but physical link is down

Constant Value: 4 (0x00000004)

DATA_ACTIVITY_IN

Added in API level 1

public static final int DATA_ACTIVITY_IN

Data connection activity: Currently receiving IP PPP traffic.

Constant Value: 1 (0x00000001)

DATA_ACTIVITY_INOUT

Added in API level 1

public static final int DATA_ACTIVITY_INOUT

Data connection activity: Currently both sending and receiving IP PPP traffic.

Constant Value: 3 (0x00000003)

DATA_ACTIVITY_NONE

Added in API level 1

public static final int DATA_ACTIVITY_NONE

Data connection activity: No traffic.

Constant Value: 0 (0x00000000)

DATA_ACTIVITY_OUT

Added in API level 1

public static final int DATA_ACTIVITY_OUT

Data connection activity: Currently sending IP PPP traffic.

Constant Value: 2 (0x00000002)

DATA_CONNECTED

Added in API level 1

public static final int DATA_CONNECTED

Data connection state: Connected. IP traffic should be available.

Constant Value: 2 (0x00000002)

DATA_CONNECTING

Added in API level 1

public static final int DATA_CONNECTING

Data connection state: Currently setting up a data connection.

Constant Value: 1 (0x00000001)

DATA_DISCONNECTED

Added in API level 1

public static final int DATA_DISCONNECTED

Data connection state: Disconnected. IP traffic not available.

Constant Value: 0 (0x00000000)

DATA_DISCONNECTING

Added in API level 30

public static final int DATA_DISCONNECTING

Data connection state: Disconnecting. IP traffic may be available but will cease working imminently.

Constant Value: 4 (0x00000004)

DATA_ENABLED_REASON_CARRIER

Added in API level 31

public static final int DATA_ENABLED_REASON_CARRIER

To indicate enable or disable carrier data by the system based on carrier signalling or carrier privileged apps. Carrier data on/off won't affect user settings but will bypass the settings and turns off data internally if set to false.

Constant Value: 2 (0x00000002)

DATA_ENABLED_REASON_OVERRIDE

Added in API level 33

public static final int DATA_ENABLED_REASON_OVERRIDE

To indicate data was enabled or disabled due to mobile data policy overrides. Note that this is not a valid reason for setDataEnabledForReason(int, boolean) and is only used to indicate that data enabled was changed due to an override.

Constant Value: 4 (0x00000004)

DATA_ENABLED_REASON_POLICY

Added in API level 31

public static final int DATA_ENABLED_REASON_POLICY

To indicate that data control due to policy. Usually used when data limit is passed. Policy data on/off won't affect user settings but will bypass the settings and turns off data internally if set to false.

Constant Value: 1 (0x00000001)

DATA_ENABLED_REASON_THERMAL

Added in API level 31

public static final int DATA_ENABLED_REASON_THERMAL

To indicate enable or disable data by thermal service. Thermal data on/off won't affect user settings but will bypass the settings and turns off data internally if set to false.

Constant Value: 3 (0x00000003)

DATA_ENABLED_REASON_UNKNOWN

Added in API level 33

public static final int DATA_ENABLED_REASON_UNKNOWN

To indicate that data was enabled or disabled due to an unknown reason. Note that this is not a valid reason for setDataEnabledForReason(int, boolean) and is only used to indicate that data enabled was changed.

Constant Value: -1 (0xffffffff)

DATA_ENABLED_REASON_USER

Added in API level 31

public static final int DATA_ENABLED_REASON_USER

To indicate that user enabled or disabled data.

Constant Value: 0 (0x00000000)

DATA_HANDOVER_IN_PROGRESS

Added in API level 33

public static final int DATA_HANDOVER_IN_PROGRESS

Data connection state: Handover in progress. The connection is being transited from cellular network to IWLAN, or from IWLAN to cellular network.

Constant Value: 5 (0x00000005)

DATA_SUSPENDED

Added in API level 1

public static final int DATA_SUSPENDED

Data connection state: Suspended. The connection is up, but IP traffic is temporarily unavailable. For example, in a 2G network, data activity may be suspended when a voice call arrives.

Constant Value: 3 (0x00000003)

DATA_UNKNOWN

Added in API level 29

public static final int DATA_UNKNOWN

Data connection state: Unknown. Used before we know the state.

Constant Value: -1 (0xffffffff)

DEFAULT_PORT_INDEX

Added in API level 33

public static final int DEFAULT_PORT_INDEX

Default port index for a UICC. On physical SIM cards the only available port is 0. See UiccPortInfo for more information on ports. See EuiccManager.isSimPortAvailable(int) for information on how portIndex is used on eUICCs.

Constant Value: 0 (0x00000000)

ERI_FLASH

Added in API level 31

public static final int ERI_FLASH

ERI (Enhanced Roaming Indicator) is FLASH i.e value 2 defined by 3GPP2 C.R1001-H v1.0 Table 8.1-1.

Constant Value: 2 (0x00000002)

ERI_OFF

Added in API level 31

public static final int ERI_OFF

ERI (Enhanced Roaming Indicator) is OFF i.e value 1 defined by 3GPP2 C.R1001-H v1.0 Table 8.1-1.

Constant Value: 1 (0x00000001)

ERI_ON

Added in API level 31

public static final int ERI_ON

ERI (Enhanced Roaming Indicator) is ON i.e value 0 defined by 3GPP2 C.R1001-H v1.0 Table 8.1-1.

Constant Value: 0 (0x00000000)

EVENT_DISPLAY_EMERGENCY_MESSAGE

Added in API level 35

public static final String EVENT_DISPLAY_EMERGENCY_MESSAGE

Event reported from the Telephony stack to indicate that the Connection is not able to find any network and likely will not get connected. Upon receiving this event, the dialer app should start the app included in the extras bundle of this event if satellite is provisioned.

The dialer app receives this event via Call.Callback.onConnectionEvent(Call, String, Bundle).

The Bundle parameter is guaranteed to include the following extras if the below conditions are met:

• EXTRA_EMERGENCY_CALL_TO_SATELLITE_HANDOVER_TYPE - the recommending handover type.
• EXTRA_EMERGENCY_CALL_TO_SATELLITE_LAUNCH_INTENT - the PendingIntent which will be launched by the Dialer app when receiving this connection event.

If the device is connected to satellite via carrier within the hysteresis time defined by the carrier config CarrierConfigManager.KEY_SATELLITE_CONNECTION_HYSTERESIS_SEC_INT, the component of the EXTRA_EMERGENCY_CALL_TO_SATELLITE_LAUNCH_INTENT will be set to the default SMS app.

Otherwise, if the overlay config config_oem_enabled_satellite_handover_app is present, the app defined by this config will be used as the component of the EXTRA_EMERGENCY_CALL_TO_SATELLITE_LAUNCH_INTENT. If this overlay config is empty, EXTRA_EMERGENCY_CALL_TO_SATELLITE_LAUNCH_INTENT will not be included in the event EVENT_DISPLAY_EMERGENCY_MESSAGE.

Constant Value: "android.telephony.event.DISPLAY_EMERGENCY_MESSAGE"

EXTRA_ACTIVE_SIM_SUPPORTED_COUNT

Added in API level 30

public static final String EXTRA_ACTIVE_SIM_SUPPORTED_COUNT

The number of active SIM supported by current multi-SIM config. It's not related to how many SIM/subscriptions are currently active. Same value will be returned by getActiveModemCount(). For single SIM mode, it's 1. For DSDS or DSDA mode, it's 2. For triple-SIM mode, it's 3. Extra of ACTION_MULTI_SIM_CONFIG_CHANGED. type: integer

Constant Value: "android.telephony.extra.ACTIVE_SIM_SUPPORTED_COUNT"

EXTRA_APN_PROTOCOL

Added in API level 31

public static final String EXTRA_APN_PROTOCOL

An integer extra containing the protocol of the apn connection. Sent with the ACTION_CARRIER_SIGNAL_PCO_VALUE broadcast. See the PROTOCOL_* constants in ApnSetting for a list of possible values.

Constant Value: "android.telephony.extra.APN_PROTOCOL"

EXTRA_APN_TYPE

Added in API level 31

public static final String EXTRA_APN_TYPE

An integer extra containing the APN type. Sent with the ACTION_CARRIER_SIGNAL_REQUEST_NETWORK_FAILED, ACTION_CARRIER_SIGNAL_REDIRECTED, and ACTION_CARRIER_SIGNAL_PCO_VALUE broadcasts. See the TYPE_ constants in ApnSetting for a list of possible values.

Constant Value: "android.telephony.extra.APN_TYPE"

EXTRA_CALL_VOICEMAIL_INTENT

Added in API level 26

public static final String EXTRA_CALL_VOICEMAIL_INTENT

The intent to call voicemail.

Constant Value: "android.telephony.extra.CALL_VOICEMAIL_INTENT"

EXTRA_CARRIER_ID

Added in API level 28

public static final String EXTRA_CARRIER_ID

An int extra used with ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED which indicates the updated carrier id returned by TelephonyManager.getSimCarrierId().

Will be TelephonyManager.UNKNOWN_CARRIER_ID if the subscription is unavailable or the carrier cannot be identified.

Constant Value: "android.telephony.extra.CARRIER_ID"

EXTRA_CARRIER_NAME

Added in API level 28

public static final String EXTRA_CARRIER_NAME

An string extra used with ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED which indicates the updated carrier name of the current subscription.

See also:

• Carrier name is a user-facing name of the carrier id {@link #EXTRA_CARRIER_ID}, usually the brand name of the subsidiary (e.g. T-Mobile).

Constant Value: "android.telephony.extra.CARRIER_NAME"

EXTRA_DATA_FAIL_CAUSE

Added in API level 31

public static final String EXTRA_DATA_FAIL_CAUSE

An integer extra containing the data fail cause. Sent with ACTION_CARRIER_SIGNAL_REQUEST_NETWORK_FAILED. See DataFailCause for a list of possible values.

Constant Value: "android.telephony.extra.DATA_FAIL_CAUSE"

EXTRA_DEFAULT_NETWORK_AVAILABLE

Added in API level 31

public static final String EXTRA_DEFAULT_NETWORK_AVAILABLE

A boolean extra indicating the availability of the default network. Sent with the ACTION_CARRIER_SIGNAL_DEFAULT_NETWORK_AVAILABLE broadcast.

Constant Value: "android.telephony.extra.DEFAULT_NETWORK_AVAILABLE"

EXTRA_EMERGENCY_CALL_TO_SATELLITE_HANDOVER_TYPE

Added in API level 35

public static final String EXTRA_EMERGENCY_CALL_TO_SATELLITE_HANDOVER_TYPE

Integer extra key used with EVENT_DISPLAY_EMERGENCY_MESSAGE which indicates the type of handover from emergency call to satellite messaging.

Will be either android.telephony.satellite.SatelliteManager#EMERGENCY_CALL_TO_SATELLITE_HANDOVER_TYPE_SOS or android.telephony.satellite.SatelliteManager#EMERGENCY_CALL_TO_SATELLITE_HANDOVER_TYPE_T911

Set in the extras for the EVENT_DISPLAY_EMERGENCY_MESSAGE connection event.

Constant Value: "android.telephony.extra.EMERGENCY_CALL_TO_SATELLITE_HANDOVER_TYPE"

EXTRA_EMERGENCY_CALL_TO_SATELLITE_LAUNCH_INTENT

Added in API level 35

public static final String EXTRA_EMERGENCY_CALL_TO_SATELLITE_LAUNCH_INTENT

Extra key used with the EVENT_DISPLAY_EMERGENCY_MESSAGE for a PendingIntent which will be launched by the Dialer app.

Constant Value: "android.telephony.extra.EMERGENCY_CALL_TO_SATELLITE_LAUNCH_INTENT"

EXTRA_HIDE_PUBLIC_SETTINGS

Added in API level 26

public static final String EXTRA_HIDE_PUBLIC_SETTINGS

The boolean value indicating whether the voicemail settings activity launched by ACTION_CONFIGURE_VOICEMAIL should hide settings accessible through public API. This is used by dialer implementations which provides their own voicemail settings UI, but still needs to expose device specific voicemail settings to the user.

See also:

• ACTION_CONFIGURE_VOICEMAIL
• METADATA_HIDE_VOICEMAIL_SETTINGS_MENU

Constant Value: "android.telephony.extra.HIDE_PUBLIC_SETTINGS"

EXTRA_INCOMING_NUMBER

Added in API level 3
Deprecated in API level 29

public static final String EXTRA_INCOMING_NUMBER

This constant was deprecated in API level 29.
Companion apps for wearable devices should use the InCallService API to retrieve the phone number for calls instead. Apps performing call screening should use the CallScreeningService API instead.

Extra key used with the ACTION_PHONE_STATE_CHANGED broadcast for a String containing the incoming or outgoing phone number.

This extra is only populated for receivers of the ACTION_PHONE_STATE_CHANGED broadcast which have been granted the Manifest.permission.READ_CALL_LOG and Manifest.permission.READ_PHONE_STATE permissions.

For incoming calls, the phone number is only guaranteed to be populated when the EXTRA_STATE changes from EXTRA_STATE_IDLE to EXTRA_STATE_RINGING. If the incoming caller is from an unknown number, the extra will be populated with an empty string. For outgoing calls, the phone number is only guaranteed to be populated when the EXTRA_STATE changes from EXTRA_STATE_IDLE to EXTRA_STATE_OFFHOOK.

Retrieve with Intent.getStringExtra(String).

Constant Value: "incoming_number"

EXTRA_IS_REFRESH

Added in API level 27

public static final String EXTRA_IS_REFRESH

Boolean value representing whether the ACTION_SHOW_VOICEMAIL_NOTIFICATION is new or a refresh of an existing notification. Notification refresh happens after reboot or connectivity changes. The user has already been notified for the voicemail so it should not alert the user, and should not be shown again if the user has dismissed it.

Constant Value: "android.telephony.extra.IS_REFRESH"

EXTRA_LAST_KNOWN_NETWORK_COUNTRY

Added in API level 34

public static final String EXTRA_LAST_KNOWN_NETWORK_COUNTRY

The extra used with an ACTION_NETWORK_COUNTRY_CHANGED to specify the last known the country code in ISO-3166-1 alpha-2 format. This might be an empty string when the country code was never available. The last known country code persists across reboot.

Retrieve with Intent.getStringExtra(String).

Constant Value: "android.telephony.extra.LAST_KNOWN_NETWORK_COUNTRY"

EXTRA_LAUNCH_VOICEMAIL_SETTINGS_INTENT

Added in API level 26

public static final String EXTRA_LAUNCH_VOICEMAIL_SETTINGS_INTENT

The intent to launch voicemail settings.

Constant Value: "android.telephony.extra.LAUNCH_VOICEMAIL_SETTINGS_INTENT"

EXTRA_NETWORK_COUNTRY

Added in API level 29

public static final String EXTRA_NETWORK_COUNTRY

The extra used with an ACTION_NETWORK_COUNTRY_CHANGED to specify the the country code in ISO-3166-1 alpha-2 format. This is the same country code returned by getNetworkCountryIso(). This might be an empty string when the country code is not available.

Retrieve with Intent.getStringExtra(String).

Constant Value: "android.telephony.extra.NETWORK_COUNTRY"

EXTRA_NOTIFICATION_COUNT

Added in API level 26

public static final String EXTRA_NOTIFICATION_COUNT

The number of voice messages associated with the notification.

Constant Value: "android.telephony.extra.NOTIFICATION_COUNT"

EXTRA_PCO_ID

Added in API level 31

public static final String EXTRA_PCO_ID

An integer extra indicating the ID for the PCO data. Sent with the ACTION_CARRIER_SIGNAL_PCO_VALUE broadcast.

Constant Value: "android.telephony.extra.PCO_ID"

EXTRA_PCO_VALUE

Added in API level 31

public static final String EXTRA_PCO_VALUE

A byte array extra containing PCO data read from the modem. Sent with the ACTION_CARRIER_SIGNAL_PCO_VALUE broadcast.

Constant Value: "android.telephony.extra.PCO_VALUE"

EXTRA_PHONE_ACCOUNT_HANDLE

Added in API level 26

public static final String EXTRA_PHONE_ACCOUNT_HANDLE

The extra used with an ACTION_CONFIGURE_VOICEMAIL and ACTION_SHOW_VOICEMAIL_NOTIFICATION Intent to specify the PhoneAccountHandle the configuration or notification is for.

Retrieve with Intent.getParcelableExtra(String).

Constant Value: "android.telephony.extra.PHONE_ACCOUNT_HANDLE"

EXTRA_REDIRECTION_URL

Added in API level 31

public static final String EXTRA_REDIRECTION_URL

String extra containing the redirection URL sent with ACTION_CARRIER_SIGNAL_REDIRECTED.

Constant Value: "android.telephony.extra.REDIRECTION_URL"

EXTRA_SPECIFIC_CARRIER_ID

Added in API level 29

public static final String EXTRA_SPECIFIC_CARRIER_ID

An int extra used with ACTION_SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED which indicates the updated specific carrier id returned by TelephonyManager.getSimSpecificCarrierId(). Note, its possible specific carrier id changes while ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED remains the same e.g, when subscription switch to different IMSIs.

Will be TelephonyManager.UNKNOWN_CARRIER_ID if the subscription is unavailable or the carrier cannot be identified.

Constant Value: "android.telephony.extra.SPECIFIC_CARRIER_ID"

EXTRA_SPECIFIC_CARRIER_NAME

Added in API level 29

public static final String EXTRA_SPECIFIC_CARRIER_NAME

An string extra used with ACTION_SUBSCRIPTION_SPECIFIC_CARRIER_IDENTITY_CHANGED which indicates the updated specific carrier name returned by TelephonyManager.getSimSpecificCarrierIdName().

it's a user-facing name of the specific carrier id EXTRA_SPECIFIC_CARRIER_ID e.g, Tracfone-AT&T

Constant Value: "android.telephony.extra.SPECIFIC_CARRIER_NAME"

EXTRA_STATE

Added in API level 3

public static final String EXTRA_STATE

The lookup key used with the ACTION_PHONE_STATE_CHANGED broadcast for a String containing the new call state.

Retrieve with Intent.getStringExtra(String).

See also:

• EXTRA_STATE_IDLE
• EXTRA_STATE_RINGING
• EXTRA_STATE_OFFHOOK

Constant Value: "state"

EXTRA_SUBSCRIPTION_ID

Added in API level 28

public static final String EXTRA_SUBSCRIPTION_ID

An int extra used with ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED to indicate the subscription which has changed; or in general whenever a subscription ID needs specified.

Constant Value: "android.telephony.extra.SUBSCRIPTION_ID"

EXTRA_VOICEMAIL_NUMBER

Added in API level 26

public static final String EXTRA_VOICEMAIL_NUMBER

The voicemail number.

Constant Value: "android.telephony.extra.VOICEMAIL_NUMBER"

INCLUDE_LOCATION_DATA_COARSE

Added in API level 33

public static final int INCLUDE_LOCATION_DATA_COARSE

Include coarse location data. Indicates whether the caller would not like to receive location related information which will be sent if the caller already possess Manifest.permission.ACCESS_COARSE_LOCATION and do not renounce the permissions.

Constant Value: 1 (0x00000001)

INCLUDE_LOCATION_DATA_FINE

Added in API level 33

public static final int INCLUDE_LOCATION_DATA_FINE

Include fine location data. Indicates whether the caller would not like to receive location related information which will be sent if the caller already possess Manifest.permission.ACCESS_FINE_LOCATION and do not renounce the permissions.

Constant Value: 2 (0x00000002)

INCLUDE_LOCATION_DATA_NONE

Added in API level 33

public static final int INCLUDE_LOCATION_DATA_NONE

Specifies to not include any location related data. Indicates whether the caller would not like to receive location related information which will be sent if the caller already possess Manifest.permission.ACCESS_COARSE_LOCATION and do not renounce the permissions.

Constant Value: 0 (0x00000000)

METADATA_HIDE_VOICEMAIL_SETTINGS_MENU

Added in API level 26

public static final String METADATA_HIDE_VOICEMAIL_SETTINGS_MENU

A boolean meta-data value indicating whether the voicemail settings should be hidden in the call settings page launched by TelecomManager.ACTION_SHOW_CALL_SETTINGS. Dialer implementations (see TelecomManager.getDefaultDialerPackage()) which would also like to manage voicemail settings should set this meta-data to true in the manifest registration of their application.

See also:

• TelecomManager.ACTION_SHOW_CALL_SETTINGS
• ACTION_CONFIGURE_VOICEMAIL
• EXTRA_HIDE_PUBLIC_SETTINGS

Constant Value: "android.telephony.HIDE_VOICEMAIL_SETTINGS_MENU"

MULTISIM_ALLOWED

Added in API level 29

public static final int MULTISIM_ALLOWED

The usage of multiple SIM cards at the same time to register on the network (e.g. Dual Standby or Dual Active) is supported.

Constant Value: 0 (0x00000000)

MULTISIM_NOT_SUPPORTED_BY_CARRIER

Added in API level 29

public static final int MULTISIM_NOT_SUPPORTED_BY_CARRIER

The usage of multiple SIM cards at the same time to register on the network (e.g. Dual Standby or Dual Active) is supported by the hardware, but restricted by the carrier.

Constant Value: 2 (0x00000002)

MULTISIM_NOT_SUPPORTED_BY_HARDWARE

Added in API level 29

public static final int MULTISIM_NOT_SUPPORTED_BY_HARDWARE

The usage of multiple SIM cards at the same time to register on the network (e.g. Dual Standby or Dual Active) is not supported by the hardware.

Constant Value: 1 (0x00000001)

NETWORK_SELECTION_MODE_AUTO

Added in API level 30

public static final int NETWORK_SELECTION_MODE_AUTO

Constant Value: 1 (0x00000001)

NETWORK_SELECTION_MODE_MANUAL

Added in API level 30

public static final int NETWORK_SELECTION_MODE_MANUAL

Constant Value: 2 (0x00000002)

NETWORK_SELECTION_MODE_UNKNOWN

Added in API level 30

public static final int NETWORK_SELECTION_MODE_UNKNOWN

Constant Value: 0 (0x00000000)

NETWORK_TYPE_1xRTT

Added in API level 4

public static final int NETWORK_TYPE_1xRTT

Current network is 1xRTT

Constant Value: 7 (0x00000007)

NETWORK_TYPE_BITMASK_1xRTT

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_1xRTT

network type bitmask indicating the support of radio tech 1xRTT.

Constant Value: 64 (0x0000000000000040)

NETWORK_TYPE_BITMASK_CDMA

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_CDMA

network type bitmask indicating the support of radio tech CDMA(IS95A/IS95B).

Constant Value: 8 (0x0000000000000008)

NETWORK_TYPE_BITMASK_EDGE

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_EDGE

network type bitmask indicating the support of radio tech EDGE.

Constant Value: 2 (0x0000000000000002)

NETWORK_TYPE_BITMASK_EHRPD

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_EHRPD

network type bitmask indicating the support of radio tech EHRPD.

Constant Value: 8192 (0x0000000000002000)

NETWORK_TYPE_BITMASK_EVDO_0

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_EVDO_0

network type bitmask indicating the support of radio tech EVDO 0.

Constant Value: 16 (0x0000000000000010)

NETWORK_TYPE_BITMASK_EVDO_A

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_EVDO_A

network type bitmask indicating the support of radio tech EVDO A.

Constant Value: 32 (0x0000000000000020)

NETWORK_TYPE_BITMASK_EVDO_B

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_EVDO_B

network type bitmask indicating the support of radio tech EVDO B.

Constant Value: 2048 (0x0000000000000800)

NETWORK_TYPE_BITMASK_GPRS

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_GPRS

network type bitmask indicating the support of radio tech GPRS.

Constant Value: 1 (0x0000000000000001)

NETWORK_TYPE_BITMASK_GSM

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_GSM

network type bitmask indicating the support of radio tech GSM.

Constant Value: 32768 (0x0000000000008000)

NETWORK_TYPE_BITMASK_HSDPA

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_HSDPA

network type bitmask indicating the support of radio tech HSDPA.

Constant Value: 128 (0x0000000000000080)

NETWORK_TYPE_BITMASK_HSPA

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_HSPA

network type bitmask indicating the support of radio tech HSPA.

Constant Value: 512 (0x0000000000000200)

NETWORK_TYPE_BITMASK_HSPAP

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_HSPAP

network type bitmask indicating the support of radio tech HSPAP.

Constant Value: 16384 (0x0000000000004000)

NETWORK_TYPE_BITMASK_HSUPA

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_HSUPA

network type bitmask indicating the support of radio tech HSUPA.

Constant Value: 256 (0x0000000000000100)

NETWORK_TYPE_BITMASK_IWLAN

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_IWLAN

network type bitmask indicating the support of radio tech IWLAN.

Constant Value: 131072 (0x0000000000020000)

NETWORK_TYPE_BITMASK_LTE

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_LTE

network type bitmask indicating the support of radio tech LTE.

Constant Value: 4096 (0x0000000000001000)

NETWORK_TYPE_BITMASK_LTE_CA

Added in API level 33
Deprecated in API level 34

public static final long NETWORK_TYPE_BITMASK_LTE_CA

This constant was deprecated in API level 34.
Please use NETWORK_TYPE_BITMASK_LTE instead. Deprecated in Android U.

NOT USED; this bitmask is exposed accidentally. If used, will be converted to NETWORK_TYPE_BITMASK_LTE. network type bitmask indicating the support of radio tech LTE CA (carrier aggregation).

Constant Value: 262144 (0x0000000000040000)

NETWORK_TYPE_BITMASK_NR

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_NR

network type bitmask indicating the support of radio tech NR(New Radio) 5G.

Constant Value: 524288 (0x0000000000080000)

NETWORK_TYPE_BITMASK_TD_SCDMA

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_TD_SCDMA

network type bitmask indicating the support of radio tech TD_SCDMA.

Constant Value: 65536 (0x0000000000010000)

NETWORK_TYPE_BITMASK_UMTS

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_UMTS

network type bitmask indicating the support of radio tech UMTS.

Constant Value: 4 (0x0000000000000004)

NETWORK_TYPE_BITMASK_UNKNOWN

Added in API level 33

public static final long NETWORK_TYPE_BITMASK_UNKNOWN

network type bitmask unknown.

Constant Value: 0 (0x0000000000000000)

NETWORK_TYPE_CDMA

Added in API level 4

public static final int NETWORK_TYPE_CDMA

Current network is CDMA: Either IS95A or IS95B

Constant Value: 4 (0x00000004)

NETWORK_TYPE_EDGE

Added in API level 1

public static final int NETWORK_TYPE_EDGE

Current network is EDGE

Constant Value: 2 (0x00000002)

NETWORK_TYPE_EHRPD

Added in API level 11

public static final int NETWORK_TYPE_EHRPD

Current network is eHRPD

Constant Value: 14 (0x0000000e)

NETWORK_TYPE_EVDO_0

Added in API level 4

public static final int NETWORK_TYPE_EVDO_0

Current network is EVDO revision 0

Constant Value: 5 (0x00000005)

NETWORK_TYPE_EVDO_A

Added in API level 4

public static final int NETWORK_TYPE_EVDO_A

Current network is EVDO revision A

Constant Value: 6 (0x00000006)

NETWORK_TYPE_EVDO_B

Added in API level 9

public static final int NETWORK_TYPE_EVDO_B

Current network is EVDO revision B

Constant Value: 12 (0x0000000c)

NETWORK_TYPE_GPRS

Added in API level 1

public static final int NETWORK_TYPE_GPRS

Current network is GPRS

Constant Value: 1 (0x00000001)

NETWORK_TYPE_GSM

Added in API level 25

public static final int NETWORK_TYPE_GSM

Current network is GSM

Constant Value: 16 (0x00000010)

NETWORK_TYPE_HSDPA

Added in API level 5

public static final int NETWORK_TYPE_HSDPA

Current network is HSDPA

Constant Value: 8 (0x00000008)

NETWORK_TYPE_HSPA

Added in API level 5

public static final int NETWORK_TYPE_HSPA

Current network is HSPA

Constant Value: 10 (0x0000000a)

NETWORK_TYPE_HSPAP

Added in API level 13

public static final int NETWORK_TYPE_HSPAP

Current network is HSPA+

Constant Value: 15 (0x0000000f)

NETWORK_TYPE_HSUPA

Added in API level 5

public static final int NETWORK_TYPE_HSUPA

Current network is HSUPA

Constant Value: 9 (0x00000009)

NETWORK_TYPE_IDEN

Added in API level 8
Deprecated in API level 34

public static final int NETWORK_TYPE_IDEN

This constant was deprecated in API level 34.
Legacy network type no longer being used starting in Android U.

Current network is iDen

Constant Value: 11 (0x0000000b)

NETWORK_TYPE_IWLAN

Added in API level 25

public static final int NETWORK_TYPE_IWLAN

Current network is IWLAN

Constant Value: 18 (0x00000012)

NETWORK_TYPE_LTE

Added in API level 11

public static final int NETWORK_TYPE_LTE

Current network is LTE

Constant Value: 13 (0x0000000d)

NETWORK_TYPE_NR

Added in API level 29

public static final int NETWORK_TYPE_NR

Current network is NR (New Radio) 5G. This will only be returned for 5G SA. For 5G NSA, the network type will be NETWORK_TYPE_LTE.

Constant Value: 20 (0x00000014)

NETWORK_TYPE_TD_SCDMA

Added in API level 25

public static final int NETWORK_TYPE_TD_SCDMA

Current network is TD_SCDMA

Constant Value: 17 (0x00000011)

NETWORK_TYPE_UMTS

Added in API level 1

public static final int NETWORK_TYPE_UMTS

Current network is UMTS

Constant Value: 3 (0x00000003)

NETWORK_TYPE_UNKNOWN

Added in API level 1

public static final int NETWORK_TYPE_UNKNOWN

Network type is unknown

Constant Value: 0 (0x00000000)

PHONE_TYPE_CDMA

Added in API level 4

public static final int PHONE_TYPE_CDMA

Phone radio is CDMA.

Constant Value: 2 (0x00000002)

PHONE_TYPE_GSM

Added in API level 1

public static final int PHONE_TYPE_GSM

Phone radio is GSM.

Constant Value: 1 (0x00000001)

PHONE_TYPE_NONE

Added in API level 1

public static final int PHONE_TYPE_NONE

No phone radio.

Constant Value: 0 (0x00000000)

PHONE_TYPE_SIP

Added in API level 11

public static final int PHONE_TYPE_SIP

Phone is via SIP.

Constant Value: 3 (0x00000003)

PREMIUM_CAPABILITY_PRIORITIZE_LATENCY

Added in API level 34

public static final int PREMIUM_CAPABILITY_PRIORITIZE_LATENCY

A premium capability that boosts the network to allow for real-time interactive traffic by prioritizing low latency communication. Corresponds to NetworkCapabilities.NET_CAPABILITY_PRIORITIZE_LATENCY.

Constant Value: 34 (0x00000022)

PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_IN_PROGRESS

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_IN_PROGRESS

Purchase premium capability failed because a request was already made and is in progress. This may have been requested by either the same app or another app. Subsequent attempts will return the same error until the previous request completes.

Constant Value: 4 (0x00000004)

PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED

Purchase premium capability failed because it is already purchased and available. Subsequent attempts will return the same error until the performance boost expires.

Constant Value: 3 (0x00000003)

PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLED

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLED

Purchase premium capability failed because the carrier disabled or does not support the capability, as specified in CarrierConfigManager.KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAY. Subsequent attempts will return the same error until the carrier enables the feature.

Constant Value: 7 (0x00000007)

PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_ERROR

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_ERROR

Purchase premium capability failed because the carrier app did not indicate success. Subsequent attempts will be throttled for the amount of time specified by #KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG and return PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.

Constant Value: 8 (0x00000008)

PURCHASE_PREMIUM_CAPABILITY_RESULT_ENTITLEMENT_CHECK_FAILED

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_ENTITLEMENT_CHECK_FAILED

Purchase premium capability failed because the entitlement check failed. Subsequent attempts will be throttled for the amount of time specified by #KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG and return PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED. Throttling will be reevaluated when the network is no longer congested.

Constant Value: 13 (0x0000000d)

PURCHASE_PREMIUM_CAPABILITY_RESULT_FEATURE_NOT_SUPPORTED

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_FEATURE_NOT_SUPPORTED

Purchase premium capability failed because the device does not support the feature. Subsequent attempts will return the same error.

Constant Value: 10 (0x0000000a)

PURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE

Purchase premium capability failed because the network is not available. Subsequent attempts will return the same error until network conditions change.

Constant Value: 12 (0x0000000c)

PURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_DEFAULT_DATA_SUBSCRIPTION

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_DEFAULT_DATA_SUBSCRIPTION

Purchase premium capability failed because the request was not made on the default data subscription, indicated by SubscriptionManager.getDefaultDataSubscriptionId(). Subsequent attempts will return the same error until the request is made on the default data subscription.

Constant Value: 14 (0x0000000e)

PURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_FOREGROUND

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_FOREGROUND

Purchase premium capability failed because the requesting application is not in the foreground. Subsequent attempts will return the same error until the requesting application moves to the foreground.

Constant Value: 5 (0x00000005)

PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP

Purchase premium capability was successful and is waiting for the network to setup the slicing configuration. If the setup is complete within the time specified by CarrierConfigManager.KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONG, subsequent requests will return PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED until the purchase expires. If the setup is not complete within the time specified above, applications can request the premium capability again.

Constant Value: 15 (0x0000000f)

PURCHASE_PREMIUM_CAPABILITY_RESULT_REQUEST_FAILED

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_REQUEST_FAILED

Purchase premium capability failed because the telephony service is unavailable or there was an error in the phone process. Subsequent attempts will return the same error until request conditions are satisfied.

Constant Value: 11 (0x0000000b)

PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS

Purchase premium capability request was successful. Once the purchase result is successful, the network must set up a slicing configuration for the purchased premium capability within the timeout specified by CarrierConfigManager.KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONG. During the setup time, subsequent attempts will return PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP. After setup is complete, subsequent attempts will return PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED until the boost expires. The expiry time is determined by the type or duration of boost purchased from the carrier, provided at CarrierConfigManager.KEY_PREMIUM_CAPABILITY_PURCHASE_URL_STRING.

Constant Value: 1 (0x00000001)

PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED

Purchase premium capability failed because the request is throttled. If purchasing premium capabilities is throttled, it will be for the amount of time specified by #KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG. If displaying the performance boost notification is throttled, it will be for the amount of time specified by #KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG. We will show the performance boost notification to the user up to the daily and monthly maximum number of times specified by CarrierConfigManager.KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INT and CarrierConfigManager.KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INT. Subsequent attempts will return the same error until the request is no longer throttled or throttling conditions change.

Constant Value: 2 (0x00000002)

PURCHASE_PREMIUM_CAPABILITY_RESULT_TIMEOUT

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_TIMEOUT

Purchase premium capability failed because we did not receive a response from the user for the performance boost notification within the time specified by CarrierConfigManager.KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG. The performance boost notification will be automatically dismissed and subsequent attempts will be throttled for the amount of time specified by #KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG and return PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.

Constant Value: 9 (0x00000009)

PURCHASE_PREMIUM_CAPABILITY_RESULT_USER_CANCELED

Added in API level 34

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_USER_CANCELED

Purchase premium capability failed because the user canceled the operation. Subsequent attempts will be throttled for the amount of time specified by #KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG and return PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.

Constant Value: 6 (0x00000006)

PURCHASE_PREMIUM_CAPABILITY_RESULT_USER_DISABLED

Added in API level 35

public static final int PURCHASE_PREMIUM_CAPABILITY_RESULT_USER_DISABLED

Purchase premium capability failed because the user disabled the feature. Subsequent attempts will be throttled for the amount of time specified by #KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG and return PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.

Constant Value: 16 (0x00000010)

SET_OPPORTUNISTIC_SUB_INACTIVE_SUBSCRIPTION

Added in API level 29

public static final int SET_OPPORTUNISTIC_SUB_INACTIVE_SUBSCRIPTION

The subscription is not valid. It must be an active opportunistic subscription.

Constant Value: 2 (0x00000002)

SET_OPPORTUNISTIC_SUB_NO_OPPORTUNISTIC_SUB_AVAILABLE

Added in API level 30

public static final int SET_OPPORTUNISTIC_SUB_NO_OPPORTUNISTIC_SUB_AVAILABLE

The subscription is not valid. It must be an opportunistic subscription.

Constant Value: 3 (0x00000003)

SET_OPPORTUNISTIC_SUB_REMOTE_SERVICE_EXCEPTION

Added in API level 30

public static final int SET_OPPORTUNISTIC_SUB_REMOTE_SERVICE_EXCEPTION

Subscription service happened remote exception.

Constant Value: 4 (0x00000004)

SET_OPPORTUNISTIC_SUB_SUCCESS

Added in API level 29

public static final int SET_OPPORTUNISTIC_SUB_SUCCESS

No error. Operation succeeded.

Constant Value: 0 (0x00000000)

SET_OPPORTUNISTIC_SUB_VALIDATION_FAILED

Added in API level 29

public static final int SET_OPPORTUNISTIC_SUB_VALIDATION_FAILED

Validation failed when trying to switch to preferred subscription.

Constant Value: 1 (0x00000001)

SIM_STATE_ABSENT

Added in API level 1

public static final int SIM_STATE_ABSENT

SIM card state: no SIM card is available in the device

Constant Value: 1 (0x00000001)

SIM_STATE_CARD_IO_ERROR

Added in API level 26

public static final int SIM_STATE_CARD_IO_ERROR

SIM card state: SIM Card Error, present but faulty

Constant Value: 8 (0x00000008)

SIM_STATE_CARD_RESTRICTED

Added in API level 26

public static final int SIM_STATE_CARD_RESTRICTED

SIM card state: SIM Card restricted, present but not usable due to carrier restrictions.

Constant Value: 9 (0x00000009)

SIM_STATE_NETWORK_LOCKED

Added in API level 1

public static final int SIM_STATE_NETWORK_LOCKED

SIM card state: Locked: requires a network PIN to unlock

Constant Value: 4 (0x00000004)

SIM_STATE_NOT_READY

Added in API level 26

public static final int SIM_STATE_NOT_READY

SIM card state: SIM Card is NOT READY

Constant Value: 6 (0x00000006)

SIM_STATE_PERM_DISABLED

Added in API level 26

public static final int SIM_STATE_PERM_DISABLED

SIM card state: SIM Card Error, permanently disabled

Constant Value: 7 (0x00000007)

SIM_STATE_PIN_REQUIRED

Added in API level 1

public static final int SIM_STATE_PIN_REQUIRED

SIM card state: Locked: requires the user's SIM PIN to unlock

Constant Value: 2 (0x00000002)

SIM_STATE_PUK_REQUIRED

Added in API level 1

public static final int SIM_STATE_PUK_REQUIRED

SIM card state: Locked: requires the user's SIM PUK to unlock

Constant Value: 3 (0x00000003)

SIM_STATE_READY

Added in API level 1

public static final int SIM_STATE_READY

SIM card state: Ready

Constant Value: 5 (0x00000005)

SIM_STATE_UNKNOWN

Added in API level 1

public static final int SIM_STATE_UNKNOWN

SIM card state: Unknown. Signifies that the SIM is in transition between states. For example, when the user inputs the SIM pin under PIN_REQUIRED state, a query for sim status returns this state before turning to SIM_STATE_READY. These are the ordinal value of IccCardConstants.State.

Constant Value: 0 (0x00000000)

UNINITIALIZED_CARD_ID

Added in API level 29

public static final int UNINITIALIZED_CARD_ID

A UICC card identifier used before the UICC card is loaded. See getCardIdForDefaultEuicc() and UiccCardInfo.getCardId().

Note that once the UICC card is loaded, the card ID may become UNSUPPORTED_CARD_ID.

Constant Value: -2 (0xfffffffe)

UNKNOWN_CARRIER_ID

Added in API level 28

public static final int UNKNOWN_CARRIER_ID

An unknown carrier id. It could either be subscription unavailable or the subscription carrier cannot be recognized. Unrecognized carriers here means MCC+MNC cannot be identified.

Constant Value: -1 (0xffffffff)

UNSUPPORTED_CARD_ID

Added in API level 29

public static final int UNSUPPORTED_CARD_ID

A UICC card identifier used if the device does not support the operation. For example, getCardIdForDefaultEuicc() returns this value if the device has no eUICC, or the eUICC cannot be read.

Constant Value: -1 (0xffffffff)

UPDATE_AVAILABLE_NETWORKS_ABORTED

Added in API level 29

public static final int UPDATE_AVAILABLE_NETWORKS_ABORTED

The request is aborted.

Constant Value: 2 (0x00000002)

UPDATE_AVAILABLE_NETWORKS_DISABLE_MODEM_FAIL

Added in API level 30

public static final int UPDATE_AVAILABLE_NETWORKS_DISABLE_MODEM_FAIL

Disable modem fail.

Constant Value: 5 (0x00000005)

UPDATE_AVAILABLE_NETWORKS_ENABLE_MODEM_FAIL

Added in API level 30

public static final int UPDATE_AVAILABLE_NETWORKS_ENABLE_MODEM_FAIL

Enable modem fail.

Constant Value: 6 (0x00000006)

UPDATE_AVAILABLE_NETWORKS_INVALID_ARGUMENTS

Added in API level 29

public static final int UPDATE_AVAILABLE_NETWORKS_INVALID_ARGUMENTS

The parameter passed in is invalid.

Constant Value: 3 (0x00000003)

UPDATE_AVAILABLE_NETWORKS_MULTIPLE_NETWORKS_NOT_SUPPORTED

Added in API level 30

public static final int UPDATE_AVAILABLE_NETWORKS_MULTIPLE_NETWORKS_NOT_SUPPORTED

Carrier app does not support multiple available networks.

Constant Value: 7 (0x00000007)

UPDATE_AVAILABLE_NETWORKS_NO_CARRIER_PRIVILEGE

Added in API level 29

public static final int UPDATE_AVAILABLE_NETWORKS_NO_CARRIER_PRIVILEGE

No carrier privilege.

Constant Value: 4 (0x00000004)

UPDATE_AVAILABLE_NETWORKS_NO_OPPORTUNISTIC_SUB_AVAILABLE

Added in API level 30

public static final int UPDATE_AVAILABLE_NETWORKS_NO_OPPORTUNISTIC_SUB_AVAILABLE

The subscription is not valid. It must be an opportunistic subscription.

Constant Value: 8 (0x00000008)

UPDATE_AVAILABLE_NETWORKS_REMOTE_SERVICE_EXCEPTION

Added in API level 30

public static final int UPDATE_AVAILABLE_NETWORKS_REMOTE_SERVICE_EXCEPTION

There is no OpportunisticNetworkService.

Constant Value: 9 (0x00000009)

UPDATE_AVAILABLE_NETWORKS_SERVICE_IS_DISABLED

Added in API level 30

public static final int UPDATE_AVAILABLE_NETWORKS_SERVICE_IS_DISABLED

OpportunisticNetworkService is disabled.

Constant Value: 10 (0x0000000a)

UPDATE_AVAILABLE_NETWORKS_SUCCESS

Added in API level 29

public static final int UPDATE_AVAILABLE_NETWORKS_SUCCESS

No error. Operation succeeded.

Constant Value: 0 (0x00000000)

UPDATE_AVAILABLE_NETWORKS_UNKNOWN_FAILURE

Added in API level 29

public static final int UPDATE_AVAILABLE_NETWORKS_UNKNOWN_FAILURE

There is a unknown failure happened.

Constant Value: 1 (0x00000001)

USSD_ERROR_SERVICE_UNAVAIL

Added in API level 26

public static final int USSD_ERROR_SERVICE_UNAVAIL

Failure code returned when a USSD request has failed to execute because the Telephony service is unavailable.

Returned via TelephonyManager.UssdResponseCallback.onReceiveUssdResponseFailed( TelephonyManager, String, int).

Constant Value: -2 (0xfffffffe)

USSD_RETURN_FAILURE

Added in API level 26

public static final int USSD_RETURN_FAILURE

Failed code returned when the mobile network has failed to complete a USSD request.

Returned via TelephonyManager.UssdResponseCallback.onReceiveUssdResponseFailed( TelephonyManager, String, int).

Constant Value: -1 (0xffffffff)

VVM_TYPE_CVVM

Added in API level 23

public static final String VVM_TYPE_CVVM

A flavor of OMTP protocol with a different mobile originated (MO) format

Constant Value: "vvm_type_cvvm"

VVM_TYPE_OMTP

Added in API level 23

public static final String VVM_TYPE_OMTP

The OMTP protocol.

Constant Value: "vvm_type_omtp"

Fields

EXTRA_STATE_IDLE

Added in API level 3

public static final String EXTRA_STATE_IDLE

Value used with EXTRA_STATE corresponding to CALL_STATE_IDLE.

EXTRA_STATE_OFFHOOK

Added in API level 3

public static final String EXTRA_STATE_OFFHOOK

Value used with EXTRA_STATE corresponding to CALL_STATE_OFFHOOK.

EXTRA_STATE_RINGING

Added in API level 3

public static final String EXTRA_STATE_RINGING

Value used with EXTRA_STATE corresponding to CALL_STATE_RINGING.

Public methods

canChangeDtmfToneLength

Added in API level 23

public boolean canChangeDtmfToneLength ()

Whether the device supports configuring the DTMF tone length.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if the DTMF tone length can be changed, and false otherwise.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

clearSignalStrengthUpdateRequest

Added in API level 31

public void clearSignalStrengthUpdateRequest (SignalStrengthUpdateRequest request)

Clear a SignalStrengthUpdateRequest from the system.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).

If the given request was not set before, this operation is a no-op.
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
request	SignalStrengthUpdateRequest: the SignalStrengthUpdateRequest to be cleared from the System This value cannot be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

See also:

• setSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)

createForPhoneAccountHandle

Added in API level 26

public TelephonyManager createForPhoneAccountHandle (PhoneAccountHandle phoneAccountHandle)

Create a new TelephonyManager object pinned to the subscription ID associated with the given phone account.

Parameters
phoneAccountHandle	PhoneAccountHandle

Returns
TelephonyManager	a TelephonyManager that uses the given phone account for all calls, or null if the phone account does not correspond to a valid subscription ID.

createForSubscriptionId

Added in API level 24

public TelephonyManager createForSubscriptionId (int subId)

Create a new TelephonyManager object pinned to the given subscription ID.

Parameters
subId	int

Returns
TelephonyManager	a TelephonyManager that uses the given subId for all calls.

doesSwitchMultiSimConfigTriggerReboot

Added in API level 29

public boolean doesSwitchMultiSimConfigTriggerReboot ()

Get whether making changes to modem configurations by switchMultiSimConfig(int) will trigger device reboot. The modem configuration change refers to switching from single SIM configuration to DSDS or the other way around.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if reboot will be triggered after making changes to modem configurations, otherwise return false.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getActiveModemCount

Added in API level 30

public int getActiveModemCount ()

Returns the number of logical modems currently configured to be activated. Returns 0 if none of voice, sms, data is not supported Returns 1 for Single standby mode (Single SIM functionality). Returns 2 for Dual standby mode (Dual SIM functionality). Returns 3 for Tri standby mode (Tri SIM functionality).

Returns
int

getAllCellInfo

Added in API level 17

public List<CellInfo> getAllCellInfo ()

Requests all available cell information from all radios on the device including the camped/registered, serving, and neighboring cells.

The response can include one or more CellInfoGsm, CellInfoCdma, CellInfoTdscdma, CellInfoLte, and CellInfoWcdma objects, in any combination. It is typical to see instances of one or more of any these in the list. In addition, zero or more of the returned objects may be considered registered; that is, their CellInfo.isRegistered() methods may return true, indicating that the cell is being used or would be used for signaling communication if necessary.

Beginning with Android Q, if this API results in a change of the cached CellInfo, that change will be reported via onCellInfoChanged().

Apps targeting Android Q or higher will no longer trigger a refresh of the cached CellInfo by invoking this API. Instead, those apps will receive the latest cached results, which may not be current. Apps targeting Android Q or higher that wish to request updated CellInfo should call requestCellInfoUpdate(); however, in all cases, updates will be rate-limited and are not guaranteed. To determine the recency of CellInfo data, callers should check CellInfo#getTimeStamp().

This method returns valid data for devices with FEATURE_TELEPHONY. In cases where only partial information is available for a particular CellInfo entry, unavailable fields will be reported as CellInfo.UNAVAILABLE. All reported cells will include at least a valid set of technology-specific identification info and a power level measurement.

This method is preferred over using getCellLocation().
Requires Manifest.permission.ACCESS_FINE_LOCATION
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
List<CellInfo>	List of CellInfo; null if cell information is unavailable.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getAllowedNetworkTypesForReason

Added in API level 33

public long getAllowedNetworkTypesForReason (int reason)

Get the allowed network types for certain reason. getAllowedNetworkTypesForReason(int) returns allowed network type for a specific reason.

Requires permission: android.Manifest.READ_PRIVILEGED_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the TelephonyManager#CAPABILITY_USES_ALLOWED_NETWORK_TYPES_BITMASK feature which can be detected using TelephonyManager.isRadioInterfaceCapabilitySupported(String).

Parameters
reason	int: the reason the allowed network type change is taking place Value is ALLOWED_NETWORK_TYPES_REASON_USER, android.telephony.TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_POWER, ALLOWED_NETWORK_TYPES_REASON_CARRIER, android.telephony.TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_ENABLE_2G, or android.telephony.TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_TEST

Returns

long

the allowed network type bitmask Value is either 0 or a combination of NETWORK_TYPE_BITMASK_UNKNOWN, NETWORK_TYPE_BITMASK_GSM, NETWORK_TYPE_BITMASK_GPRS, NETWORK_TYPE_BITMASK_EDGE, NETWORK_TYPE_BITMASK_CDMA, NETWORK_TYPE_BITMASK_1xRTT, NETWORK_TYPE_BITMASK_EVDO_0, NETWORK_TYPE_BITMASK_EVDO_A, NETWORK_TYPE_BITMASK_EVDO_B, NETWORK_TYPE_BITMASK_EHRPD, NETWORK_TYPE_BITMASK_HSUPA, NETWORK_TYPE_BITMASK_HSDPA, NETWORK_TYPE_BITMASK_HSPA, NETWORK_TYPE_BITMASK_HSPAP, NETWORK_TYPE_BITMASK_UMTS, NETWORK_TYPE_BITMASK_TD_SCDMA, NETWORK_TYPE_BITMASK_LTE, NETWORK_TYPE_BITMASK_LTE_CA, NETWORK_TYPE_BITMASK_NR, NETWORK_TYPE_BITMASK_IWLAN, and android.telephony.TelephonyManager.NETWORK_TYPE_BITMASK_IDEN

Throws
IllegalStateException	if the Telephony process is not currently available.
IllegalArgumentException	if invalid AllowedNetworkTypesReason is passed.
SecurityException	if the caller does not have the required permission/privileges
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getCallComposerStatus

Added in API level 31

public int getCallComposerStatus ()

Get the user-set status for enriched calling with call composer.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId()
Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	the user-set status for enriched calling with call composer, either of CALL_COMPOSER_STATUS_ON or CALL_COMPOSER_STATUS_OFF. Value is CALL_COMPOSER_STATUS_ON, CALL_COMPOSER_STATUS_OFF, or CALL_COMPOSER_STATUS_BUSINESS_ONLY

Throws
SecurityException	if the caller does not have the permission.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

getCallState

Added in API level 1
Deprecated in API level 31

public int getCallState ()

This method was deprecated in API level 31.
Use getCallStateForSubscription() to retrieve the call state for a specific telephony subscription (which allows carrier privileged apps), TelephonyCallback.CallStateListener for real-time call state updates, or TelecomManager.isInCall(), which supplies an aggregate "in call" state for the entire device.

Returns the state of all calls on the device.

This method considers not only calls in the Telephony stack, but also calls via other ConnectionService implementations.

Note: The call state returned via this method may differ from what is reported by TelephonyCallback.CallStateListener.onCallStateChanged(int), as that callback only considers Telephony (mobile) calls.

Requires Permission: READ_PHONE_STATE for applications targeting API level 31+.

Returns
int	the current call state. Value is CALL_STATE_IDLE, CALL_STATE_RINGING, or CALL_STATE_OFFHOOK

getCallStateForSubscription

Added in API level 31

public int getCallStateForSubscription ()

Retrieve the call state for a specific subscription that was specified when this TelephonyManager instance was created.

Requires Permission: READ_PHONE_STATE or that the calling application has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	The call state of the subscription associated with this TelephonyManager instance. Value is CALL_STATE_IDLE, CALL_STATE_RINGING, or CALL_STATE_OFFHOOK

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

See also:

• createForSubscriptionId(int)
• createForPhoneAccountHandle(PhoneAccountHandle)

getCardIdForDefaultEuicc

Added in API level 29

public int getCardIdForDefaultEuicc ()

Get the card ID of the default eUICC card. If the eUICCs have not yet been loaded, returns UNINITIALIZED_CARD_ID. If there is no eUICC or the device does not support card IDs for eUICCs, returns UNSUPPORTED_CARD_ID.

The card ID is a unique identifier associated with a UICC or eUICC card. Card IDs are unique to a device, and always refer to the same UICC or eUICC card unless the device goes through a factory reset.
Requires the PackageManager#FEATURE_TELEPHONY_EUICC feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	card ID of the default eUICC card, if loaded.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_EUICC.

getCarrierConfig

Added in API level 26

public PersistableBundle getCarrierConfig ()

Returns the carrier config of the subscription ID pinned to the TelephonyManager. If an invalid subscription ID is pinned to the TelephonyManager, the returned config will contain default values.

This method may take several seconds to complete, so it should only be called from a worker thread.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
This method may take several seconds to complete, so it should only be called from a worker thread.
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
PersistableBundle

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

See also:

• CarrierConfigManager.getConfigForSubId(int)
• createForSubscriptionId(int)
• createForPhoneAccountHandle(PhoneAccountHandle)

getCarrierIdFromSimMccMnc

Added in API level 29

public int getCarrierIdFromSimMccMnc ()

Returns carrier id based on sim MCCMNC (returned by getSimOperator()) only. This is used for fallback when configurations/logic for exact carrier id getSimCarrierId() are not found. Android carrier id table here can be updated out-of-band, its possible a MVNO (Mobile Virtual Network Operator) carrier was not fully recognized and assigned to its MNO (Mobile Network Operator) carrier id by default. After carrier id table update, a new carrier id was assigned. If apps don't take the update with the new id, it might be helpful to always fallback by using carrier id based on MCCMNC if there is no match.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	matching carrier id from sim MCCMNC. Return UNKNOWN_CARRIER_ID if the subscription is unavailable or the carrier cannot be identified.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getCarrierRestrictionStatus

Added in API level 34

public void getCarrierRestrictionStatus (Executor executor, 
                Consumer<Integer> resultListener)

Get the carrier restriction status of the device.

To fetch the carrier restriction status of the device the calling application needs to be allowlisted to Android at here. The calling application also needs the READ_PHONE_STATE permission. The return value of the API is as follows.

• return CARRIER_RESTRICTION_STATUS_RESTRICTED_TO_CALLER if the caller and the device locked by the network are same
• return CARRIER_RESTRICTION_STATUS_RESTRICTED if the caller and the device locked by the network are different
• return CARRIER_RESTRICTION_STATUS_NOT_RESTRICTED if the device is not locked
• return CARRIER_RESTRICTION_STATUS_UNKNOWN if the device locking state is unavailable or radio does not supports the feature

Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).
Requires Manifest.permission.READ_BASIC_PHONE_STATE or Manifest.permission.READ_PHONE_STATE

Parameters
executor	Executor: The executor on which the result listener will be called. This value cannot be null.
resultListener	Consumer: Consumer that will be called with the carrier restriction status result fetched from the radio This value cannot be null. Value is CARRIER_RESTRICTION_STATUS_UNKNOWN, CARRIER_RESTRICTION_STATUS_NOT_RESTRICTED, CARRIER_RESTRICTION_STATUS_RESTRICTED, or CARRIER_RESTRICTION_STATUS_RESTRICTED_TO_CALLER

Throws
SecurityException	if the caller does not have the required permission/privileges or if the caller is not pre-registered.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getCellLocation

Added in API level 1
Deprecated in API level 26

public CellLocation getCellLocation ()

This method was deprecated in API level 26.
use getAllCellInfo() instead, which returns a superset of this API.

Returns the current location of the device.

If there is only one radio in the device and that radio has an LTE connection, this method will return null. The implementation must not to try add LTE identifiers into the existing cdma/gsm classes.

Requires Manifest.permission.ACCESS_FINE_LOCATION
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
CellLocation	Current location of the device or null if not available.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getDataActivity

Added in API level 1

public int getDataActivity ()

Returns a constant indicating the type of activity on a data connection (cellular).
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

See also:

• DATA_ACTIVITY_NONE
• DATA_ACTIVITY_IN
• DATA_ACTIVITY_OUT
• DATA_ACTIVITY_INOUT
• DATA_ACTIVITY_DORMANT

getDataNetworkType

Added in API level 24

public int getDataNetworkType ()

Returns a constant indicating the radio technology (network type) currently in use on the device for data transmission. If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getActiveDataSubscriptionId(). Note: Before SubscriptionManager.getActiveDataSubscriptionId() was introduced in API level 30, it was applied to SubscriptionManager.getDefaultDataSubscriptionId() which may be different now from SubscriptionManager.getActiveDataSubscriptionId(), e.g. when opportunistic network is providing cellular internet connection to the user.

Requires Permission: READ_PHONE_STATE or READ_BASIC_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE or Manifest.permission.READ_BASIC_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns

int

the network type Value is NETWORK_TYPE_UNKNOWN, NETWORK_TYPE_GPRS, NETWORK_TYPE_EDGE, NETWORK_TYPE_UMTS, NETWORK_TYPE_CDMA, NETWORK_TYPE_EVDO_0, NETWORK_TYPE_EVDO_A, NETWORK_TYPE_1xRTT, NETWORK_TYPE_HSDPA, NETWORK_TYPE_HSUPA, NETWORK_TYPE_HSPA, NETWORK_TYPE_IDEN, NETWORK_TYPE_EVDO_B, NETWORK_TYPE_LTE, NETWORK_TYPE_EHRPD, NETWORK_TYPE_HSPAP, NETWORK_TYPE_GSM, NETWORK_TYPE_TD_SCDMA, NETWORK_TYPE_IWLAN, or NETWORK_TYPE_NR

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

See also:

• NETWORK_TYPE_UNKNOWN
• NETWORK_TYPE_GPRS
• NETWORK_TYPE_EDGE
• NETWORK_TYPE_UMTS
• NETWORK_TYPE_HSDPA
• NETWORK_TYPE_HSUPA
• NETWORK_TYPE_HSPA
• NETWORK_TYPE_CDMA
• NETWORK_TYPE_EVDO_0
• NETWORK_TYPE_EVDO_A
• NETWORK_TYPE_EVDO_B
• NETWORK_TYPE_1xRTT
• NETWORK_TYPE_IDEN
• NETWORK_TYPE_LTE
• NETWORK_TYPE_EHRPD
• NETWORK_TYPE_HSPAP
• NETWORK_TYPE_NR

getDataState

Added in API level 1

public int getDataState ()

Returns a constant indicating the current data connection state (cellular).
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

See also:

• DATA_DISCONNECTED
• DATA_CONNECTING
• DATA_CONNECTED
• DATA_SUSPENDED
• DATA_DISCONNECTING
• DATA_HANDOVER_IN_PROGRESS

getDeviceId

Added in API level 1
Deprecated in API level 26

public String getDeviceId ()

This method was deprecated in API level 26.
Use getImei() which returns IMEI for GSM or getMeid() which returns MEID for CDMA.

Returns the unique device ID, for example, the IMEI for GSM and the MEID or ESN for CDMA phones. Return null if device ID is not available.

Starting with API level 29, persistent device identifiers are guarded behind additional restrictions, and apps are recommended to use resettable identifiers (see Best practices for unique identifiers). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()) on any active subscription.
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).

If the calling app does not meet one of these requirements then this method will behave as follows:

• If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then null is returned.
• If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE

Returns
String

getDeviceId

Added in API level 23
Deprecated in API level 26

public String getDeviceId (int slotIndex)

This method was deprecated in API level 26.
Use getImei() which returns IMEI for GSM or getMeid() which returns MEID for CDMA.

Returns the unique device ID of a subscription, for example, the IMEI for GSM and the MEID for CDMA phones. Return null if device ID is not available.

Starting with API level 29, persistent device identifiers are guarded behind additional restrictions, and apps are recommended to use resettable identifiers (see Best practices for unique identifiers). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()) on any active subscription.
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).

If the calling app does not meet one of these requirements then this method will behave as follows:

• If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then null is returned.
• If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE

Parameters
slotIndex	int: of which deviceID is returned

Returns
String

getDeviceSoftwareVersion

Added in API level 1

public String getDeviceSoftwareVersion ()

Returns the software version number for the device, for example, the IMEI/SV for GSM phones. Return null if the software version is not available.

Requires Manifest.permission.READ_PHONE_STATE or Manifest.permission.READ_BASIC_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY.

getEmergencyNumberList

Added in API level 29

public Map<Integer, List<EmergencyNumber>> getEmergencyNumberList ()

Get the emergency number list based on current locale, sim, default, modem and network.

In each returned list, the emergency number EmergencyNumber coming from higher priority sources will be located at the smaller index; the priority order of sources are: EmergencyNumber.EMERGENCY_NUMBER_SOURCE_NETWORK_SIGNALING > EmergencyNumber.EMERGENCY_NUMBER_SOURCE_SIM > EmergencyNumber.EMERGENCY_NUMBER_SOURCE_DATABASE > EmergencyNumber.EMERGENCY_NUMBER_SOURCE_DEFAULT > EmergencyNumber.EMERGENCY_NUMBER_SOURCE_MODEM_CONFIG

The subscriptions which the returned list would be based on, are all the active subscriptions, no matter which subscription could be used to create TelephonyManager.

Requires permission Manifest.permission.READ_PHONE_STATE or the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
Map<Integer, List<EmergencyNumber>>	Map including the keys as the active subscription IDs (Note: if there is no active subscription, the key is SubscriptionManager.getDefaultSubscriptionId) and the value as the list of EmergencyNumber; empty Map if this information is not available; or throw a SecurityException if the caller does not have the permission. This value cannot be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

getEmergencyNumberList

Added in API level 29

public Map<Integer, List<EmergencyNumber>> getEmergencyNumberList (int categories)

Get the per-category emergency number list based on current locale, sim, default, modem and network.

In each returned list, the emergency number EmergencyNumber coming from higher priority sources will be located at the smaller index; the priority order of sources are: EmergencyNumber.EMERGENCY_NUMBER_SOURCE_NETWORK_SIGNALING > EmergencyNumber.EMERGENCY_NUMBER_SOURCE_SIM > EmergencyNumber.EMERGENCY_NUMBER_SOURCE_DATABASE > EmergencyNumber.EMERGENCY_NUMBER_SOURCE_DEFAULT > EmergencyNumber.EMERGENCY_NUMBER_SOURCE_MODEM_CONFIG

The subscriptions which the returned list would be based on, are all the active subscriptions, no matter which subscription could be used to create TelephonyManager.

Requires permission Manifest.permission.READ_PHONE_STATE or the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters

categories

int: the emergency service categories which are the bitwise-OR combination of the following constants: EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_UNSPECIFIED EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_POLICE EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_AMBULANCE EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_FIRE_BRIGADE EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_MARINE_GUARD EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_MOUNTAIN_RESCUE EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_MIEC EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_AIEC Value is either 0 or a combination of EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_UNSPECIFIED, EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_POLICE, EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_AMBULANCE, EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_FIRE_BRIGADE, EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_MARINE_GUARD, EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_MOUNTAIN_RESCUE, EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_MIEC, and EmergencyNumber.EMERGENCY_SERVICE_CATEGORY_AIEC

Returns
Map<Integer, List<EmergencyNumber>>	Map including the keys as the active subscription IDs (Note: if there is no active subscription, the key is SubscriptionManager.getDefaultSubscriptionId) and the value as the list of EmergencyNumber; empty Map if this information is not available; or throw a SecurityException if the caller does not have the permission. This value cannot be null.

Throws
IllegalStateException	if the Telephony process is not currently available.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

getEquivalentHomePlmns

Added in API level 31

public List<String> getEquivalentHomePlmns ()

Returns a list of the equivalent home PLMNs (EF_EHPLMN) from the USIM app.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
List<String>	A list of equivalent home PLMNs. Returns an empty list if EF_EHPLMN is empty or does not exist on the SIM card. This value cannot be null.

Throws
IllegalStateException	if the Telephony process is not currently available.
SecurityException	if the caller doesn't have the permission.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getForbiddenPlmns

Added in API level 26

public String[] getForbiddenPlmns ()

Returns an array of Forbidden PLMNs from the USIM App Returns null if the query fails.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String[]	an array of forbidden PLMNs or null if not available

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getGroupIdLevel1

Added in API level 18

public String getGroupIdLevel1 ()

Returns the Group Identifier Level1 for a GSM phone. Return null if it is unavailable.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getIccAuthentication

Added in API level 24

public String getIccAuthentication (int appType, 
                int authType, 
                String data)

Returns the response of authentication for the default subscription. Returns null if the authentication hasn't been successful

Requires one of the following permissions:

• READ_PRIVILEGED_PHONE_STATE
• the calling app has carrier privileges (see hasCarrierPrivileges()).
• the calling app has been granted the Manifest.permission.USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER permission.

Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
appType	int: the icc application type, like APPTYPE_USIM
authType	int: the authentication type, any one of AUTHTYPE_EAP_AKA or AUTHTYPE_EAP_SIM or AUTHTYPE_GBA_BOOTSTRAP or AUTHTYPE_GBA_NAF_KEY_EXTERNAL Value is AUTHTYPE_EAP_SIM, AUTHTYPE_EAP_AKA, AUTHTYPE_GBA_BOOTSTRAP, or AUTHTYPE_GBA_NAF_KEY_EXTERNAL
data	String: authentication challenge data, base64 encoded. See 3GPP TS 31.102 7.1.2 for more details.

Returns
String	the response of authentication. This value will be null in the following cases: Authentication error, incorrect MAC Authentication error, security context not supported Key freshness failure Authentication error, no memory space available Authentication error, no memory space available in EFMUK

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION or doesn't support given authType.

getImei

Added in API level 26

public String getImei (int slotIndex)

Returns the IMEI (International Mobile Equipment Identity). Return null if IMEI is not available.

Starting with API level 29, persistent device identifiers are guarded behind additional restrictions, and apps are recommended to use resettable identifiers (see Best practices for unique identifiers). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()) on any active subscription.
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).
• If the calling app has been granted the Manifest.permission.USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER permission.

If the calling app does not meet one of these requirements then this method will behave as follows:

• If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then null is returned.
• If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE

Parameters
slotIndex	int: of which IMEI is returned

Returns
String

getImei

Added in API level 26

public String getImei ()

Returns the IMEI (International Mobile Equipment Identity). Return null if IMEI is not available. See getImei(int) for details on the required permissions and behavior when the caller does not hold sufficient permissions.
Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE

Returns
String

getLine1Number

Added in API level 1
Deprecated in API level 33

public String getLine1Number ()

This method was deprecated in API level 33.
use SubscriptionManager.getPhoneNumber(int) instead.

Returns the phone number string for line 1, for example, the MSISDN for a GSM phone for a particular subscription. Return null if it is unavailable.

The default SMS app can also use this.

Requires Permission: READ_SMS, READ_PHONE_NUMBERS, that the caller is the default SMS app, or that the caller has carrier privileges (see hasCarrierPrivileges()) for any API level. READ_PHONE_STATE for apps targeting SDK API level 29 and below.
Requires Manifest.permission.READ_PHONE_STATE or Manifest.permission.READ_SMS or Manifest.permission.READ_PHONE_NUMBERS
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getManualNetworkSelectionPlmn

Added in API level 30

public String getManualNetworkSelectionPlmn ()

Get the PLMN chosen for Manual Network Selection if active. Return empty string if in automatic selection.

Requires Permission: READ_PRECISE_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges())
Requires Manifest.permission.READ_PRECISE_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String	manually selected network info on success or empty string on failure This value cannot be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getManufacturerCode

Added in API level 29

public String getManufacturerCode (int slotIndex)

Returns the Manufacturer Code from the MEID. Return null if Manufacturer Code is not available.
Requires the PackageManager#FEATURE_TELEPHONY_CDMA feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
slotIndex	int: of which Type Allocation Code is returned

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CDMA.

getManufacturerCode

Added in API level 29

public String getManufacturerCode ()

Returns the Manufacturer Code from the MEID. Return null if Manufacturer Code is not available.
Requires the PackageManager#FEATURE_TELEPHONY_CDMA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CDMA.

getMaximumCallComposerPictureSize

Added in API level 31

public static long getMaximumCallComposerPictureSize ()

Indicates the maximum size of the call composure picture. Pictures sent via uploadCallComposerPicture(java.io.InputStream, java.lang.String, java.util.concurrent.Executor, android.os.OutcomeReceiver) or uploadCallComposerPicture(java.nio.file.Path, java.lang.String, java.util.concurrent.Executor, android.os.OutcomeReceiver) must not exceed this size, or an error will be returned via the callback in those methods.
Value is a non-negative number of bytes.

Returns
long	Maximum file size in bytes. Value is a non-negative number of bytes.

getMeid

Added in API level 26

public String getMeid ()

Returns the MEID (Mobile Equipment Identifier). Return null if MEID is not available.

Starting with API level 29, persistent device identifiers are guarded behind additional restrictions, and apps are recommended to use resettable identifiers (see Best practices for unique identifiers). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()) on any active subscription.
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).

If the calling app does not meet one of these requirements then this method will behave as follows:

• If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then null is returned.
• If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CDMA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CDMA.

getMeid

Added in API level 26

public String getMeid (int slotIndex)

Returns the MEID (Mobile Equipment Identifier). Return null if MEID is not available.

Starting with API level 29, persistent device identifiers are guarded behind additional restrictions, and apps are recommended to use resettable identifiers (see Best practices for unique identifiers). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()) on any active subscription.
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).

If the calling app does not meet one of these requirements then this method will behave as follows:

• If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then null is returned.
• If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CDMA feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
slotIndex	int: of which MEID is returned

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CDMA.

getMmsUAProfUrl

Added in API level 19

public String getMmsUAProfUrl ()

Returns the MMS user agent profile URL.
Requires the PackageManager#FEATURE_TELEPHONY_MESSAGING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_MESSAGING.

getMmsUserAgent

Added in API level 19

public String getMmsUserAgent ()

Returns the MMS user agent.
Requires the PackageManager#FEATURE_TELEPHONY_MESSAGING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_MESSAGING.

getNai

Added in API level 28

public String getNai ()

Returns the Network Access Identifier (NAI). Return null if NAI is not available.

Starting with API level 29, persistent device identifiers are guarded behind additional restrictions, and apps are recommended to use resettable identifiers (see Best practices for unique identifiers). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()).
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).

If the calling app does not meet one of these requirements then this method will behave as follows:

• If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then null is returned.
• If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getNetworkCountryIso

Added in API level 1

public String getNetworkCountryIso ()

Returns the ISO-3166-1 alpha-2 country code equivalent of the MCC (Mobile Country Code) of the current registered operator or the cell nearby, if available. Note: Result may be unreliable on CDMA networks (use getPhoneType() to determine if on a CDMA network).

Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String	the lowercase 2 character ISO-3166-1 alpha-2 country code, or empty string if not available.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getNetworkCountryIso

Added in API level 30

public String getNetworkCountryIso (int slotIndex)

Returns the ISO-3166-1 alpha-2 country code equivalent of the MCC (Mobile Country Code) of the current registered operator or the cell nearby, if available. This is same as getNetworkCountryIso() but allowing specifying the SIM slot index. This is used for accessing network country info from the SIM slot that does not have SIM inserted. Note: Result may be unreliable on CDMA networks (use getPhoneType() to determine if on a CDMA network).

Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
slotIndex	int: the SIM slot index to get network country ISO.

Returns
String	the lowercase 2 character ISO-3166-1 alpha-2 country code, or empty string if not available. This value cannot be null.

Throws
IllegalArgumentException	when the slotIndex is invalid.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getNetworkOperator

Added in API level 1

public String getNetworkOperator ()

Returns the numeric name (MCC+MNC) of current registered operator.

Availability: Only when user is registered to a network. Result may be unreliable on CDMA networks (use getPhoneType() to determine if on a CDMA network).
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

getNetworkOperatorName

Added in API level 1

public String getNetworkOperatorName ()

Returns the alphabetic name of current registered operator.

Availability: Only when user is registered to a network. Result may be unreliable on CDMA networks (use getPhoneType() to determine if on a CDMA network).
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

getNetworkSelectionMode

Added in API level 30

public int getNetworkSelectionMode ()

Get the network selection mode.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId()

Requires Permission: READ_PRECISE_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE or Manifest.permission.READ_PRECISE_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	the network selection mode. Value is NETWORK_SELECTION_MODE_UNKNOWN, NETWORK_SELECTION_MODE_AUTO, or NETWORK_SELECTION_MODE_MANUAL

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getNetworkSlicingConfiguration

Added in API level 31

public void getNetworkSlicingConfiguration (Executor executor, 
                OutcomeReceiver<NetworkSlicingConfig, TelephonyManager.NetworkSlicingException> callback)

Request to get the current slicing configuration including URSP rules and NSSAIs (configured, allowed and rejected). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app has carrier privileges (see hasCarrierPrivileges()).

This will be invalid if the device does not support android.telephony.TelephonyManager#CAPABILITY_SLICING_CONFIG_SUPPORTED.
Requires the TelephonyManager#CAPABILITY_SLICING_CONFIG_SUPPORTED feature which can be detected using TelephonyManager.isRadioInterfaceCapabilitySupported(String).
Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE

Parameters
executor	Executor: the executor on which callback will be invoked. This value cannot be null. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread.
callback	OutcomeReceiver: a callback to receive the current slicing configuration. This value cannot be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getNetworkSpecifier

Added in API level 26

public String getNetworkSpecifier ()

Returns the network specifier of the subscription ID pinned to the TelephonyManager. The network specifier is used by NetworkRequest.Builder.setNetworkSpecifier(String) to create a NetworkRequest that connects through the subscription.
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

See also:

• NetworkRequest.Builder.setNetworkSpecifier(String)
• createForSubscriptionId(int)
• createForPhoneAccountHandle(PhoneAccountHandle)

getNetworkType

Added in API level 1
Deprecated in API level 30

public int getNetworkType ()

This method was deprecated in API level 30.
use getDataNetworkType()

Return the current data network type.
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns

int

the NETWORK_TYPE_xxxx for current data connection. Value is NETWORK_TYPE_UNKNOWN, NETWORK_TYPE_GPRS, NETWORK_TYPE_EDGE, NETWORK_TYPE_UMTS, NETWORK_TYPE_CDMA, NETWORK_TYPE_EVDO_0, NETWORK_TYPE_EVDO_A, NETWORK_TYPE_1xRTT, NETWORK_TYPE_HSDPA, NETWORK_TYPE_HSUPA, NETWORK_TYPE_HSPA, NETWORK_TYPE_IDEN, NETWORK_TYPE_EVDO_B, NETWORK_TYPE_LTE, NETWORK_TYPE_EHRPD, NETWORK_TYPE_HSPAP, NETWORK_TYPE_GSM, NETWORK_TYPE_TD_SCDMA, NETWORK_TYPE_IWLAN, or NETWORK_TYPE_NR

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getPhoneAccountHandle

Added in API level 31

public PhoneAccountHandle getPhoneAccountHandle ()

Determines the PhoneAccountHandle associated with this TelephonyManager.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId()

Requires Permission android.Manifest.permission#READ_PRIVILEGED_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges())
Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
PhoneAccountHandle	The PhoneAccountHandle associated with the TelphonyManager, or null if there is no associated PhoneAccountHandle; this can happen if the subscription is data-only or an opportunistic subscription.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

getPhoneCount

Added in API level 23
Deprecated in API level 30

public int getPhoneCount ()

This method was deprecated in API level 30.
Use getActiveModemCount() instead.

Returns the number of phones available. Returns 0 if none of voice, sms, data is not supported Returns 1 for Single standby mode (Single SIM functionality). Returns 2 for Dual standby mode (Dual SIM functionality). Returns 3 for Tri standby mode (Tri SIM functionality).

Returns
int

getPhoneType

Added in API level 1

public int getPhoneType ()

Returns a constant indicating the device phone type. This indicates the type of radio used to transmit voice/data calls.
Requires the PackageManager#FEATURE_TELEPHONY feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY.

See also:

• PHONE_TYPE_NONE
• PHONE_TYPE_GSM
• PHONE_TYPE_CDMA
• PHONE_TYPE_SIP

getPreferredOpportunisticDataSubscription

Added in API level 29

public int getPreferredOpportunisticDataSubscription ()

Get preferred opportunistic data subscription Id

Requires that the calling app has carrier privileges (see hasCarrierPrivileges()), or has either READ_PRIVILEGED_PHONE_STATE or READ_PHONE_STATE permission.
Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE or Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	subId preferred opportunistic subscription id or SubscriptionManager.DEFAULT_SUBSCRIPTION_ID if there are no preferred subscription id

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

getPrimaryImei

Added in API level 34

public String getPrimaryImei ()

Returns the primary IMEI (International Mobile Equipment Identity) of the device as mentioned in GSMA TS.37. getImei(int) returns the IMEI that belongs to the selected slotID whereas this API getPrimaryImei() returns primary IMEI of the device. A single SIM device with only one IMEI will be set by default as primary IMEI. A multi-SIM device with multiple IMEIs will have one of the IMEIs set as primary as mentioned in GSMA TS37_2.2_REQ_8.

Requires one of the following permissions

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()) on any active subscription.
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).
• If the calling app has been granted the Manifest.permission.USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER permission.

Returns
String	Primary IMEI of type string This value cannot be null.

Throws
SecurityException	if the caller does not have the required permission/privileges

getServiceState

Added in API level 33

public ServiceState getServiceState (int includeLocationData)

Returns the current ServiceState information.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId() If you want continuous updates of service state info, register a TelephonyCallback that implements TelephonyCallback.ServiceStateListener through registerTelephonyCallback(int, Executor, TelephonyCallback). There's another way to renounce permissions with a custom context AttributionSource.Builder#setRenouncedPermissions(Set<String>) but only for system apps. To avoid confusion, calling this method supersede renouncing permissions with a custom context.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()) and Manifest.permission.ACCESS_COARSE_LOCATION.
Requires Manifest.permission.READ_PHONE_STATE and Manifest.permission.ACCESS_COARSE_LOCATION
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
includeLocationData	int: Specifies if the caller would like to receive location related information. May return null when the subscription is inactive or when there was an error communicating with the phone process. Value is INCLUDE_LOCATION_DATA_NONE, INCLUDE_LOCATION_DATA_COARSE, or INCLUDE_LOCATION_DATA_FINE

Returns
ServiceState	This value may be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getServiceState

Added in API level 26

public ServiceState getServiceState ()

Returns the current ServiceState information.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId() If you want continuous updates of service state info, register a TelephonyCallback that implements TelephonyCallback.ServiceStateListener through registerTelephonyCallback(int, Executor, TelephonyCallback).

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()) and Manifest.permission.ACCESS_COARSE_LOCATION. May return null when the subscription is inactive or when there was an error communicating with the phone process.
Requires Manifest.permission.READ_PHONE_STATE and Manifest.permission.ACCESS_COARSE_LOCATION
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
ServiceState

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getSignalStrength

Added in API level 28

public SignalStrength getSignalStrength ()

Get the most recently available signal strength information. Get the most recent SignalStrength information reported by the modem. Due to power saving this information may not always be current.
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
SignalStrength	the most recent cached signal strength info from the modem This value may be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getSimCarrierId

Added in API level 28

public int getSimCarrierId ()

Returns carrier id of the current subscription.

To recognize a carrier (including MVNO) as a first-class identity, Android assigns each carrier with a canonical integer a.k.a. carrier id. The carrier ID is an Android platform-wide identifier for a carrier. AOSP maintains carrier ID assignments in here

Apps which have carrier-specific configurations or business logic can use the carrier id as an Android platform-wide identifier for carriers.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	Carrier id of the current subscription. Return UNKNOWN_CARRIER_ID if the subscription is unavailable or the carrier cannot be identified.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getSimCarrierIdName

Added in API level 28

public CharSequence getSimCarrierIdName ()

Returns carrier id name of the current subscription.

Carrier id name is a user-facing name of carrier id returned by getSimCarrierId(), usually the brand name of the subsidiary (e.g. T-Mobile). Each carrier could configure multiple SPN but should have a single carrier name. Carrier name is not a canonical identity, use getSimCarrierId() instead.

The returned carrier name is unlocalized.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
CharSequence	Carrier name of the current subscription. Return null if the subscription is unavailable or the carrier cannot be identified.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getSimCountryIso

Added in API level 1

public String getSimCountryIso ()

Returns the ISO-3166-1 alpha-2 country code equivalent for the SIM provider's country code.

The ISO-3166-1 alpha-2 country code is provided in lowercase 2 character format.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String	the lowercase 2 character ISO-3166-1 alpha-2 country code, or empty string is not available.

getSimOperator

Added in API level 1

public String getSimOperator ()

Returns the MCC+MNC (mobile country code + mobile network code) of the provider of the SIM. 5 or 6 decimal digits.

Availability: SIM state must be SIM_STATE_READY
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

See also:

• getSimState()

getSimOperatorName

Added in API level 1

public String getSimOperatorName ()

Returns the Service Provider Name (SPN).

Availability: SIM state must be SIM_STATE_READY
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

See also:

• getSimState()

getSimSerialNumber

Added in API level 1

public String getSimSerialNumber ()

Returns the serial number of the SIM, if applicable. Return null if it is unavailable.

Starting with API level 29, persistent device identifiers are guarded behind additional restrictions, and apps are recommended to use resettable identifiers (see Best practices for unique identifiers). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()).
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).

If the calling app does not meet one of these requirements then this method will behave as follows:

• If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then null is returned.
• If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getSimSpecificCarrierId

Added in API level 29

public int getSimSpecificCarrierId ()

Returns fine-grained carrier ID of the current subscription. A specific carrier ID can represent the fact that a carrier may be in effect an aggregation of other carriers (ie in an MVNO type scenario) where each of these specific carriers which are used to make up the actual carrier service may have different carrier configurations. A specific carrier ID could also be used, for example, in a scenario where a carrier requires different carrier configuration for different service offering such as a prepaid plan. the specific carrier ID would be used for configuration purposes, but apps wishing to know about the carrier itself should use the regular carrier ID returned by getSimCarrierId(). e.g, Tracfone SIMs could return different specific carrier ID based on IMSI from current subscription while carrier ID remains the same.

For carriers without fine-grained specific carrier ids, return getSimCarrierId()

Specific carrier ids are defined in the same way as carrier id here except each with a "parent" id linking to its top-level carrier id.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	Returns fine-grained carrier id of the current subscription. Return UNKNOWN_CARRIER_ID if the subscription is unavailable or the carrier cannot be identified.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getSimSpecificCarrierIdName

Added in API level 29

public CharSequence getSimSpecificCarrierIdName ()

Similar like getSimCarrierIdName(), returns user-facing name of the specific carrier id returned by getSimSpecificCarrierId(). The specific carrier ID would be used for configuration purposes, but apps wishing to know about the carrier itself should use the regular carrier ID returned by getSimCarrierIdName().

The returned name is unlocalized.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
CharSequence	user-facing name of the subscription specific carrier id. Return null if the subscription is unavailable or the carrier cannot be identified.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getSimState

Added in API level 1

public int getSimState ()

Returns a constant indicating the state of the default SIM card.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	Value is SIM_STATE_UNKNOWN, SIM_STATE_ABSENT, SIM_STATE_PIN_REQUIRED, SIM_STATE_PUK_REQUIRED, SIM_STATE_NETWORK_LOCKED, SIM_STATE_READY, SIM_STATE_NOT_READY, SIM_STATE_PERM_DISABLED, SIM_STATE_CARD_IO_ERROR, SIM_STATE_CARD_RESTRICTED, android.telephony.TelephonyManager.SIM_STATE_LOADED, or android.telephony.TelephonyManager.SIM_STATE_PRESENT

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

See also:

• SIM_STATE_UNKNOWN
• SIM_STATE_ABSENT
• SIM_STATE_PIN_REQUIRED
• SIM_STATE_PUK_REQUIRED
• SIM_STATE_NETWORK_LOCKED
• SIM_STATE_READY
• SIM_STATE_NOT_READY
• SIM_STATE_PERM_DISABLED
• SIM_STATE_CARD_IO_ERROR
• SIM_STATE_CARD_RESTRICTED

getSimState

Added in API level 26

public int getSimState (int slotIndex)

Returns a constant indicating the state of the device SIM card in a logical slot.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
slotIndex	int: logical slot index

Returns
int	Value is SIM_STATE_UNKNOWN, SIM_STATE_ABSENT, SIM_STATE_PIN_REQUIRED, SIM_STATE_PUK_REQUIRED, SIM_STATE_NETWORK_LOCKED, SIM_STATE_READY, SIM_STATE_NOT_READY, SIM_STATE_PERM_DISABLED, SIM_STATE_CARD_IO_ERROR, SIM_STATE_CARD_RESTRICTED, android.telephony.TelephonyManager.SIM_STATE_LOADED, or android.telephony.TelephonyManager.SIM_STATE_PRESENT

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

See also:

• SIM_STATE_UNKNOWN
• SIM_STATE_ABSENT
• SIM_STATE_PIN_REQUIRED
• SIM_STATE_PUK_REQUIRED
• SIM_STATE_NETWORK_LOCKED
• SIM_STATE_READY
• SIM_STATE_NOT_READY
• SIM_STATE_PERM_DISABLED
• SIM_STATE_CARD_IO_ERROR
• SIM_STATE_CARD_RESTRICTED

getSubscriberId

Added in API level 1

public String getSubscriberId ()

Returns the unique subscriber ID, for example, the IMSI for a GSM phone. Return null if it is unavailable.

Starting with API level 29, persistent device identifiers are guarded behind additional restrictions, and apps are recommended to use resettable identifiers (see Best practices for unique identifiers). This method can be invoked if one of the following requirements is met:

• If the calling app has been granted the READ_PRIVILEGED_PHONE_STATE permission; this is a privileged permission that can only be granted to apps preloaded on the device.
• If the calling app is the device owner of a fully-managed device, a profile owner of an organization-owned device, or their delegates (see DevicePolicyManager.getEnrollmentSpecificId()).
• If the calling app has carrier privileges (see hasCarrierPrivileges()).
• If the calling app is the default SMS role holder (see RoleManager.isRoleHeld(java.lang.String)).
• If the calling app has been granted the Manifest.permission.USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER permission.

If the calling app does not meet one of these requirements then this method will behave as follows:

• If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then null is returned.
• If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getSubscriptionId

Added in API level 30

public int getSubscriptionId (PhoneAccountHandle phoneAccountHandle)

Returns the subscription ID for the given phone account handle.
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
phoneAccountHandle	PhoneAccountHandle: the phone account handle for outgoing calls This value cannot be null.

Returns
int	subscription ID for the given phone account handle; or SubscriptionManager.INVALID_SUBSCRIPTION_ID if not available; or throw a SecurityException if the caller doesn't have the permission.

getSubscriptionId

Added in API level 30

public int getSubscriptionId ()

Return an appropriate subscription ID for any situation. If this object has been created with createForSubscriptionId(int), then the provided subscription ID is returned. Otherwise, the default subscription ID will be returned.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int

getSupportedModemCount

Added in API level 30

public int getSupportedModemCount ()

Return how many logical modem can be potentially active simultaneously, in terms of hardware capability. It might return different value from getActiveModemCount(). For example, for a dual-SIM capable device operating in single SIM mode (only one logical modem is turned on), getActiveModemCount() returns 1 while this API returns 2.

Returns
int

getSupportedRadioAccessFamily

Added in API level 33

public long getSupportedRadioAccessFamily ()

Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns

long

Modem supported radio access family bitmask Requires permission: android.Manifest.READ_PRIVILEGED_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()). Value is either 0 or a combination of NETWORK_TYPE_BITMASK_UNKNOWN, NETWORK_TYPE_BITMASK_GSM, NETWORK_TYPE_BITMASK_GPRS, NETWORK_TYPE_BITMASK_EDGE, NETWORK_TYPE_BITMASK_CDMA, NETWORK_TYPE_BITMASK_1xRTT, NETWORK_TYPE_BITMASK_EVDO_0, NETWORK_TYPE_BITMASK_EVDO_A, NETWORK_TYPE_BITMASK_EVDO_B, NETWORK_TYPE_BITMASK_EHRPD, NETWORK_TYPE_BITMASK_HSUPA, NETWORK_TYPE_BITMASK_HSDPA, NETWORK_TYPE_BITMASK_HSPA, NETWORK_TYPE_BITMASK_HSPAP, NETWORK_TYPE_BITMASK_UMTS, NETWORK_TYPE_BITMASK_TD_SCDMA, NETWORK_TYPE_BITMASK_LTE, NETWORK_TYPE_BITMASK_LTE_CA, NETWORK_TYPE_BITMASK_NR, NETWORK_TYPE_BITMASK_IWLAN, and android.telephony.TelephonyManager.NETWORK_TYPE_BITMASK_IDEN

Throws
SecurityException	if the caller does not have the required permission
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

getTypeAllocationCode

Added in API level 29

public String getTypeAllocationCode ()

Returns the Type Allocation Code from the IMEI. Return null if Type Allocation Code is not available.

Returns
String

getTypeAllocationCode

Added in API level 29

public String getTypeAllocationCode (int slotIndex)

Returns the Type Allocation Code from the IMEI. Return null if Type Allocation Code is not available.

Parameters
slotIndex	int: of which Type Allocation Code is returned

Returns
String

getUiccCardsInfo

Added in API level 29

public List<UiccCardInfo> getUiccCardsInfo ()

Gets information about currently inserted UICCs and eUICCs.

Requires that the calling app has carrier privileges (see hasCarrierPrivileges()).

If the caller has carrier priviliges on any active subscription, then they have permission to get simple information like the card ID (UiccCardInfo.getCardId()), whether the card is an eUICC (UiccCardInfo.isEuicc()), and the physical slot index where the card is inserted (UiccCardInfo.getPhysicalSlotIndex().

To get private information such as the EID (UiccCardInfo.getEid()) or ICCID (UiccCardInfo.getIccId()), the caller must have carrier priviliges on that specific UICC or eUICC card.

See UiccCardInfo for more details on the kind of information available.
Requires android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
List<UiccCardInfo>	a list of UiccCardInfo objects, representing information on the currently inserted UICCs and eUICCs. Each UiccCardInfo in the list will have private information filtered out if the caller does not have adequate permissions for that card. This value cannot be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

getVisualVoicemailPackageName

Added in API level 26

public String getVisualVoicemailPackageName ()

Returns the package responsible of processing visual voicemail for the subscription ID pinned to the TelephonyManager. Returns null when there is no package responsible for processing visual voicemail for the subscription.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

See also:

• createForSubscriptionId(int)
• createForPhoneAccountHandle(PhoneAccountHandle)
• VisualVoicemailService

getVoiceMailAlphaTag

Added in API level 1

public String getVoiceMailAlphaTag ()

Retrieves the alphabetic identifier associated with the voice mail number.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

getVoiceMailNumber

Added in API level 1

public String getVoiceMailNumber ()

Returns the voice mail number. Return null if it is unavailable.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
String

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

getVoiceNetworkType

Added in API level 24

public int getVoiceNetworkType ()

Returns the NETWORK_TYPE_xxxx for voice

Requires Permission: READ_PHONE_STATE or READ_BASIC_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE or Manifest.permission.READ_BASIC_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns

int

Value is NETWORK_TYPE_UNKNOWN, NETWORK_TYPE_GPRS, NETWORK_TYPE_EDGE, NETWORK_TYPE_UMTS, NETWORK_TYPE_CDMA, NETWORK_TYPE_EVDO_0, NETWORK_TYPE_EVDO_A, NETWORK_TYPE_1xRTT, NETWORK_TYPE_HSDPA, NETWORK_TYPE_HSUPA, NETWORK_TYPE_HSPA, NETWORK_TYPE_IDEN, NETWORK_TYPE_EVDO_B, NETWORK_TYPE_LTE, NETWORK_TYPE_EHRPD, NETWORK_TYPE_HSPAP, NETWORK_TYPE_GSM, NETWORK_TYPE_TD_SCDMA, NETWORK_TYPE_IWLAN, or NETWORK_TYPE_NR

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

getVoicemailRingtoneUri

Added in API level 24

public Uri getVoicemailRingtoneUri (PhoneAccountHandle accountHandle)

Returns the URI for the per-account voicemail ringtone set in Phone settings.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
accountHandle	PhoneAccountHandle: The handle for the PhoneAccount for which to retrieve the voicemail ringtone.

Returns
Uri	The URI for the ringtone to play when receiving a voicemail from a specific PhoneAccount. May be null if no ringtone is set.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

hasCarrierPrivileges

Added in API level 22

public boolean hasCarrierPrivileges ()

Has the calling application been granted carrier privileges by the carrier. If any of the packages in the calling UID has carrier privileges, the call will return true. This access is granted by the owner of the UICC card and does not depend on the registered carrier. Note that this API applies to both physical and embedded subscriptions and is a superset of the checks done in SubscriptionManager#canManageSubscription.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if the app has carrier privileges.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

hasIccCard

Added in API level 5

public boolean hasIccCard ()

This API is used to check if there is an ICC card present in the device. An ICC card is a smart card that contains a subscriber identity module (SIM) and is used to identify and authenticate users to a mobile network. Note: In case of embedded SIM there is an ICC card always present irrespective of whether an active SIM profile is present or not so this API would always return true.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if a ICC card is present.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

iccCloseLogicalChannel

Added in API level 21

public boolean iccCloseLogicalChannel (int channel)

Closes a previously opened logical channel to the ICC card. Input parameters equivalent to TS 27.007 AT+CCHC command. It is strongly recommended that callers of this API should firstly create new TelephonyManager instance by calling TelephonyManager.createForSubscriptionId(int). Failure to do so can result in unpredictable and detrimental behavior like callers can end up talking to the wrong SIM card.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
channel	int: is the channel id to be closed as returned by a successful iccOpenLogicalChannel.

Returns
boolean	true if the channel was closed successfully.

Throws
IllegalArgumentException	if input parameters are wrong. e.g., invalid channel
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

iccExchangeSimIO

Added in API level 21

public byte[] iccExchangeSimIO (int fileID, 
                int command, 
                int p1, 
                int p2, 
                int p3, 
                String filePath)

Returns the response APDU for a command APDU sent through SIM_IO.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
p1	int: P1 value of the APDU command.
p2	int: P2 value of the APDU command.
p3	int: P3 value of the APDU command.

Returns
byte[]	The APDU response.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

iccOpenLogicalChannel

Added in API level 26

public IccOpenLogicalChannelResponse iccOpenLogicalChannel (String AID, 
                int p2)

Opens a logical channel to the ICC card. This operation wraps two APDU instructions:

• MANAGE CHANNEL to open a logical channel
• SELECT the given AID using the given p2

Per Open Mobile API Specification v3.2 section 6.2.7.h, only p2 values of 0x00, 0x04, 0x08, and 0x0C are guaranteed to be supported. If the SELECT command's status word is not '9000', '62xx', or '63xx', the status word will be considered an error and the channel shall not be opened. Input parameters equivalent to TS 27.007 AT+CCHO command. It is strongly recommended that callers of this should firstly create a new TelephonyManager instance by calling TelephonyManager.createForSubscriptionId(int). Failure to do so can result in unpredictable and detrimental behavior like callers can end up talking to the wrong SIM card.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
AID	String: Application id. See ETSI 102.221 and 101.220.
p2	int: P2 parameter (described in ISO 7816-4).

Returns
IccOpenLogicalChannelResponse	an IccOpenLogicalChannelResponse object.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

iccOpenLogicalChannel

Added in API level 21
Deprecated in API level 26

public IccOpenLogicalChannelResponse iccOpenLogicalChannel (String AID)

This method was deprecated in API level 26.
Replaced by iccOpenLogicalChannel(java.lang.String, int)

Opens a logical channel to the ICC card. Input parameters equivalent to TS 27.007 AT+CCHO command.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
AID	String: Application id. See ETSI 102.221 and 101.220.

Returns
IccOpenLogicalChannelResponse	an IccOpenLogicalChannelResponse object.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

iccTransmitApduBasicChannel

Added in API level 21

public String iccTransmitApduBasicChannel (int cla, 
                int instruction, 
                int p1, 
                int p2, 
                int p3, 
                String data)

Transmit an APDU to the ICC card over the basic channel. Input parameters equivalent to TS 27.007 AT+CSIM command.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
cla	int: Class of the APDU command.
instruction	int: Instruction of the APDU command.
p1	int: P1 value of the APDU command.
p2	int: P2 value of the APDU command.
p3	int: P3 value of the APDU command. If p3 is negative a 4 byte APDU is sent to the SIM.
data	String: Data to be sent with the APDU.

Returns
String	The APDU response from the ICC card with the status appended at the end.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

iccTransmitApduLogicalChannel

Added in API level 21

public String iccTransmitApduLogicalChannel (int channel, 
                int cla, 
                int instruction, 
                int p1, 
                int p2, 
                int p3, 
                String data)

Transmit an APDU to the ICC card over a logical channel. Input parameters equivalent to TS 27.007 AT+CGLA command. It is strongly recommended that callers of this API should firstly create a new TelephonyManager instance by calling TelephonyManager.createForSubscriptionId(int). Failure to do so can result in unpredictable and detrimental behavior like callers can end up talking to the wrong SIM card.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
channel	int: is the channel id to be closed as returned by a successful iccOpenLogicalChannel.
cla	int: Class of the APDU command.
instruction	int: Instruction of the APDU command.
p1	int: P1 value of the APDU command.
p2	int: P2 value of the APDU command.
p3	int: P3 value of the APDU command. If p3 is negative a 4 byte APDU is sent to the SIM.
data	String: Data to be sent with the APDU.

Returns
String	The APDU response from the ICC card with the status appended at the end.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

isConcurrentVoiceAndDataSupported

Added in API level 26

public boolean isConcurrentVoiceAndDataSupported ()

Whether the device is currently on a technology (e.g. UMTS or LTE) which can support voice and data simultaneously. This can change based on location or network condition.
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if simultaneous voice and data supported, and false otherwise.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

isDataCapable

Added in API level 31

public boolean isDataCapable ()

Returns
boolean	true if the current device is "data capable" over a radio on the device. "Data capable" means that this device supports packet-switched data connections over the telephony network.

isDataConnectionAllowed

Added in API level 31

public boolean isDataConnectionAllowed ()

Checks whether cellular data connection is allowed in the device.

Whether cellular data connection is allowed considers all factors below:

• User turned on data setting isDataEnabled().
• Carrier allows data to be on.
• Network policy.
• And possibly others.

Requires Manifest.permission.ACCESS_NETWORK_STATE or Manifest.permission.READ_PHONE_STATE or android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE or Manifest.permission.READ_BASIC_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if the overall data connection is allowed; false if not.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

isDataEnabled

Added in API level 26

public boolean isDataEnabled ()

Returns whether mobile data is enabled or not per user setting. There are other factors that could disable mobile data, but they are not considered here. If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultDataSubscriptionId()

Requires one of the following permissions: Manifest.permission.ACCESS_NETWORK_STATE, Manifest.permission.MODIFY_PHONE_STATE, or READ_BASIC_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).

Note that this does not take into account any data restrictions that may be present on the calling app. Such restrictions may be inspected with ConnectivityManager.getRestrictBackgroundStatus.
Requires Manifest.permission.ACCESS_NETWORK_STATE or Manifest.permission.MODIFY_PHONE_STATE or Manifest.permission.READ_PHONE_STATE or Manifest.permission.READ_BASIC_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if mobile data is enabled.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

isDataEnabledForReason

Added in API level 31

public boolean isDataEnabledForReason (int reason)

Return whether data is enabled for certain reason . If isDataEnabledForReason(int) returns false, it means in data enablement for a specific reason is turned off. If any of the reason is off, then it will result in bypassing user preference and result in data to be turned off. Call isDataConnectionAllowed() in order to know whether data connection is allowed on the device.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultDataSubscriptionId()
Requires Manifest.permission.ACCESS_NETWORK_STATE or Manifest.permission.READ_PHONE_STATE or Manifest.permission.MODIFY_PHONE_STATE or Manifest.permission.READ_BASIC_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
reason	int: the reason the data enable change is taking place Value is DATA_ENABLED_REASON_USER, DATA_ENABLED_REASON_POLICY, DATA_ENABLED_REASON_CARRIER, or DATA_ENABLED_REASON_THERMAL

Returns
boolean	whether data is enabled for a reason. Requires Permission: The calling app has carrier privileges (see hasCarrierPrivileges()) or READ_PHONE_STATE or Manifest.permission.ACCESS_NETWORK_STATE or Manifest.permission.MODIFY_PHONE_STATE Manifest.permission.READ_BASIC_PHONE_STATE

Throws
IllegalStateException	if the Telephony process is not currently available.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

isDataRoamingEnabled

Added in API level 29

public boolean isDataRoamingEnabled ()

Returns whether mobile data roaming is enabled on the subscription.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultDataSubscriptionId()

Requires one of the following permissions: Manifest.permission.ACCESS_NETWORK_STATE, Manifest.permission.READ_PHONE_STATE or READ_BASIC_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.ACCESS_NETWORK_STATE or Manifest.permission.READ_PHONE_STATE or Manifest.permission.READ_BASIC_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if the data roaming is enabled on the subscription, otherwise return

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA. false.

isDeviceSmsCapable

Added in API level 35

public boolean isDeviceSmsCapable ()

Returns

boolean

true if the current device supports SMS service. If true, this means that the device supports both sending and receiving SMS via the telephony network. Note: Voicemail waiting SMS, cell broadcasting SMS, and MMS are disabled when device doesn't support SMS. Starting from Android 15, SMS capability may also be overridden by carriers for a given subscription on an SMS capable device. To check if a subscription is "SMS capable", call method SubscriptionInfo.getServiceCapabilities() and check if SubscriptionManager.SERVICE_CAPABILITY_SMS is included.

See also:

• SubscriptionInfo.getServiceCapabilities()

isDeviceVoiceCapable

Added in API level 35

public boolean isDeviceVoiceCapable ()

Returns

boolean

true if the current device is "voice capable". "Voice capable" means that this device supports circuit-switched or IMS packet switched (i.e. voice) phone calls over the telephony network, and is allowed to display the in-call UI while a cellular voice call is active. This will be false on "data only" devices which can't make voice calls and don't support any in-call UI. Note: the meaning of this flag is subtly different from the PackageManager .FEATURE_TELEPHONY system feature, which is available on any device with a telephony radio, even if the device is data-only. Starting from Android 15, voice capability may also be overridden by carrier for a given subscription on a voice capable device. To check if a subscription is "voice capable", call method SubscriptionInfo.getServiceCapabilities() and check if SubscriptionManager.SERVICE_CAPABILITY_VOICE is included.

See also:

• SubscriptionInfo.getServiceCapabilities()

isEmergencyNumber

Added in API level 29

public boolean isEmergencyNumber (String number)

Identifies if the supplied phone number is an emergency number that matches a known emergency number based on current locale, SIM card(s), Android database, modem, network, or defaults.

This method assumes that only dialable phone numbers are passed in; non-dialable numbers are not considered emergency numbers. A dialable phone number consists only of characters/digits identified by PhoneNumberUtils.isDialable(char).

The subscriptions which the identification would be based on, are all the active subscriptions, no matter which subscription could be used to create TelephonyManager.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
number	String: - the number to look up This value cannot be null.

Returns
boolean	true if the given number is an emergency number based on current locale, SIM card(s), Android database, modem, network or defaults; false otherwise.

Throws
IllegalStateException	if the Telephony process is not currently available.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

isHearingAidCompatibilitySupported

Added in API level 23

public boolean isHearingAidCompatibilitySupported ()

Whether the phone supports hearing aid compatibility.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if the device supports hearing aid compatibility, and false otherwise.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

isManualNetworkSelectionAllowed

Added in API level 30

public boolean isManualNetworkSelectionAllowed ()

Checks if manual network selection is allowed.

Requires Permission: READ_PRECISE_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges())

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId().
Requires Manifest.permission.READ_PRECISE_PHONE_STATE or android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if manual network selection is allowed, otherwise return false.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

isModemEnabledForSlot

Added in API level 30

public boolean isModemEnabledForSlot (int slotIndex)

Indicates whether or not there is a modem stack enabled for the given SIM slot.

Requires Permission: READ_PHONE_STATE, READ_PRIVILEGED_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE or android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
slotIndex	int: which slot it's checking.

Returns
boolean

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY.

isMultiSimSupported

Added in API level 29

public int isMultiSimSupported ()

Returns if the usage of multiple SIM cards at the same time to register on the network (e.g. Dual Standby or Dual Active) is supported by the device and by the carrier.

Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.READ_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
int	MULTISIM_ALLOWED if the device supports multiple SIMs. MULTISIM_NOT_SUPPORTED_BY_HARDWARE if the device does not support multiple SIMs. MULTISIM_NOT_SUPPORTED_BY_CARRIER in the device supports multiple SIMs, but the functionality is restricted by the carrier. Value is MULTISIM_ALLOWED, MULTISIM_NOT_SUPPORTED_BY_HARDWARE, or MULTISIM_NOT_SUPPORTED_BY_CARRIER

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

isNetworkRoaming

Added in API level 1

public boolean isNetworkRoaming ()

Returns true if the device is considered roaming on the current network, for GSM purposes.

Availability: Only when user registered to a network.
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean

isPremiumCapabilityAvailableForPurchase

Added in API level 34

public boolean isPremiumCapabilityAvailableForPurchase (int capability)

Check whether the given premium capability is available for purchase from the carrier. If this is true, the capability can be purchased from the carrier using purchasePremiumCapability(int, java.util.concurrent.Executor, java.util.function.Consumer).
Requires Manifest.permission.READ_BASIC_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
capability	int: The premium capability to check. Value is PREMIUM_CAPABILITY_PRIORITIZE_LATENCY

Returns
boolean	Whether the given premium capability is available to purchase.

Throws
SecurityException	if the caller does not hold permission READ_BASIC_PHONE_STATE.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

isRadioInterfaceCapabilitySupported

Added in API level 31

public boolean isRadioInterfaceCapabilitySupported (String capability)

Whether the device supports a given capability on the radio interface. If the capability is not in the set of radio interface capabilities, false is returned.
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
capability	String: the name of the capability to check for This value cannot be null. Value is CAPABILITY_SLICING_CONFIG_SUPPORTED, or android.telephony.TelephonyManager.CAPABILITY_SIM_PHONEBOOK_IN_MODEM

Returns
boolean	the availability of the capability

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

isRttSupported

Added in API level 29

public boolean isRttSupported ()

Determines whether the device currently supports RTT (Real-time text). Based both on carrier support for the feature and device firmware support.
Requires the PackageManager#FEATURE_TELEPHONY_IMS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if the device and carrier both support RTT, false otherwise.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_IMS.

isSmsCapable

Added in API level 21
Deprecated in API level 35

public boolean isSmsCapable ()

This method was deprecated in API level 35.
Replaced by isDeviceSmsCapable(). Starting from Android 15, SMS capability may also be overridden by carriers for a given subscription. For SMS capable device (when isDeviceSmsCapable() return true), caller should check for subscription-level SMS capability as well. See isDeviceSmsCapable() for details.

Returns
boolean	true if the current device supports sms service. If true, this means that the device supports both sending and receiving sms via the telephony network. Note: Voicemail waiting sms, cell broadcasting sms, and MMS are disabled when device doesn't support sms.

isTtyModeSupported

Added in API level 23
Deprecated in API level 28

public boolean isTtyModeSupported ()

This method was deprecated in API level 28.
Use TelecomManager.isTtySupported() instead Whether the phone supports TTY mode.

Returns
boolean	true if the device supports TTY mode, and false otherwise.

isVoiceCapable

Added in API level 22
Deprecated in API level 35

public boolean isVoiceCapable ()

This method was deprecated in API level 35.
Replaced by isDeviceVoiceCapable(). Starting from Android 15, voice capability may also be overridden by carriers for a given subscription. For voice capable device (when isDeviceVoiceCapable() return true), caller should check for subscription-level voice capability as well. See isDeviceVoiceCapable() for details.

Returns

boolean

true if the current device is "voice capable". "Voice capable" means that this device supports circuit-switched (i.e. voice) phone calls over the telephony network, and is allowed to display the in-call UI while a cellular voice call is active. This will be false on "data only" devices which can't make voice calls and don't support any in-call UI. Note: the meaning of this flag is subtly different from the PackageManager.FEATURE_TELEPHONY system feature, which is available on any device with a telephony radio, even if the device is data-only.

isVoicemailVibrationEnabled

Added in API level 24

public boolean isVoicemailVibrationEnabled (PhoneAccountHandle accountHandle)

Returns whether vibration is set for voicemail notification in Phone settings.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
accountHandle	PhoneAccountHandle: The handle for the PhoneAccount for which to retrieve the voicemail vibration setting.

Returns
boolean	true if the vibration is set for this PhoneAccount, false otherwise.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

isWorldPhone

Added in API level 23

public boolean isWorldPhone ()

Whether the device is a world phone.
Requires the PackageManager#FEATURE_TELEPHONY feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true if the device is a world phone, and false otherwise.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY.

listen

Added in API level 1
Deprecated in API level 31

public void listen (PhoneStateListener listener, 
                int events)

This method was deprecated in API level 31.
Use registerTelephonyCallback(java.util.concurrent.Executor, android.telephony.TelephonyCallback).

Registers a listener object to receive notification of changes in specified telephony states.

To register a listener, pass a PhoneStateListener and specify at least one telephony state of interest in the events argument. At registration, and when a specified telephony state changes, the telephony manager invokes the appropriate callback method on the listener object and passes the current (updated) values.

To un-register a listener, pass the listener object and set the events argument to LISTEN_NONE (0). If this TelephonyManager object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId(). To listen events for multiple subIds, pass a separate listener object to each TelephonyManager object created with createForSubscriptionId(int). Note: if you call this method while in the middle of a binder transaction, you must call Binder.clearCallingIdentity() before calling this method. A SecurityException will be thrown otherwise. This API should be used sparingly -- large numbers of listeners will cause system instability. If a process has registered too many listeners without unregistering them, it may encounter an IllegalStateException when trying to register more listeners.

Parameters
listener	PhoneStateListener: The PhoneStateListener object to register (or unregister)
events	int: The telephony state(s) of interest to the listener, as a bitwise-OR combination of PhoneStateListener LISTEN_ flags.

purchasePremiumCapability

Added in API level 34

public void purchasePremiumCapability (int capability, 
                Executor executor, 
                Consumer<Integer> callback)

Purchase the given premium capability from the carrier. This requires user action to purchase the boost from the carrier. If this returns PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS or PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED, applications can request the premium capability via ConnectivityManager.requestNetwork.
Requires Manifest.permission.READ_BASIC_PHONE_STATE and Manifest.permission.INTERNET
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
capability	int: The premium capability to purchase. Value is PREMIUM_CAPABILITY_PRIORITIZE_LATENCY
executor	Executor: The callback executor for the response. This value cannot be null. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread.
callback	Consumer: The result of the purchase request. This value cannot be null. Value is PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS, PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED, PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED, PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_IN_PROGRESS, PURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_FOREGROUND, PURCHASE_PREMIUM_CAPABILITY_RESULT_USER_CANCELED, PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLED, PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_ERROR, PURCHASE_PREMIUM_CAPABILITY_RESULT_TIMEOUT, PURCHASE_PREMIUM_CAPABILITY_RESULT_FEATURE_NOT_SUPPORTED, PURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE, PURCHASE_PREMIUM_CAPABILITY_RESULT_ENTITLEMENT_CHECK_FAILED, PURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_DEFAULT_DATA_SUBSCRIPTION, PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP, or PURCHASE_PREMIUM_CAPABILITY_RESULT_USER_DISABLED

Throws
SecurityException	if the caller does not hold permissions READ_BASIC_PHONE_STATE or INTERNET.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

See also:

• to check whether the capability is valid.

rebootModem

Added in API level 33

public void rebootModem ()

Generate a radio modem reset. Used for device configuration by some carriers.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Throws
IllegalStateException	if the Telephony process is not currently available.
	java.lang.RuntimeException
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

registerTelephonyCallback

Added in API level 31

public void registerTelephonyCallback (Executor executor, 
                TelephonyCallback callback)

Registers a callback object to receive notification of changes in specified telephony states.

To register a callback, pass a TelephonyCallback which implements interfaces of events. For example, FakeServiceStateCallback extends TelephonyCallback implements TelephonyCallback.ServiceStateListener. At registration, and when a specified telephony state changes, the telephony manager invokes the appropriate callback method on the callback object and passes the current (updated) values.

Note: Be aware of the permission requirements stated on the TelephonyCallback listeners you implement. Your application must be granted these permissions in order to register a TelephonyCallback which requires them; a SecurityException will be thrown if you do not hold the required permissions for all TelephonyCallback listeners you implement.

If this TelephonyManager object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId(). To register events for multiple subIds, pass a separate callback object to each TelephonyManager object created with createForSubscriptionId(int). Note: if you call this method while in the middle of a binder transaction, you must call Binder.clearCallingIdentity() before calling this method. A SecurityException will be thrown otherwise. This API should be used sparingly -- large numbers of callbacks will cause system instability. If a process has registered too many callbacks without unregistering them, it may encounter an IllegalStateException when trying to register more callbacks.

Parameters
executor	Executor: The executor of where the callback will execute. This value cannot be null. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread.
callback	TelephonyCallback: The TelephonyCallback object to register. The caller should hold a reference to the callback. The framework only holds a weak reference. This value cannot be null.

registerTelephonyCallback

Added in API level 33

public void registerTelephonyCallback (int includeLocationData, 
                Executor executor, 
                TelephonyCallback callback)

Registers a callback object to receive notification of changes in specified telephony states.

To register a callback, pass a TelephonyCallback which implements interfaces of events. For example, FakeServiceStateCallback extends TelephonyCallback implements TelephonyCallback.ServiceStateListener. At registration, and when a specified telephony state changes, the telephony manager invokes the appropriate callback method on the callback object and passes the current (updated) values.

If this TelephonyManager object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId(). To register events for multiple subIds, pass a separate callback object to each TelephonyManager object created with createForSubscriptionId(int). Note: if you call this method while in the middle of a binder transaction, you must call Binder.clearCallingIdentity() before calling this method. A SecurityException will be thrown otherwise. This API should be used sparingly -- large numbers of callbacks will cause system instability. If a process has registered too many callbacks without unregistering them, it may encounter an IllegalStateException when trying to register more callbacks.

There's another way to renounce permissions with a custom context AttributionSource.Builder#setRenouncedPermissions(Set<String>) but only for system apps. To avoid confusion, calling this method supersede renouncing permissions with a custom context.

Parameters
includeLocationData	int: Specifies if the caller would like to receive location related information. Value is INCLUDE_LOCATION_DATA_NONE, INCLUDE_LOCATION_DATA_COARSE, or INCLUDE_LOCATION_DATA_FINE
executor	Executor: The executor of where the callback will execute. This value cannot be null. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread.
callback	TelephonyCallback: The TelephonyCallback object to register. The caller should hold a reference to the callback. The framework only holds a weak reference. This value cannot be null.

requestCellInfoUpdate

Added in API level 29

public void requestCellInfoUpdate (Executor executor, 
                TelephonyManager.CellInfoCallback callback)

Requests all available cell information from the current subscription for observed camped/registered, serving, and neighboring cells.

Any available results from this request will be provided by calls to onCellInfoChanged() for each active subscription.

This method returns valid data for devices with FEATURE_TELEPHONY. On devices that do not implement this feature, the behavior is not reliable.
Requires Manifest.permission.ACCESS_FINE_LOCATION
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
executor	Executor: the executor on which callback will be invoked. This value cannot be null. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread.
callback	TelephonyManager.CellInfoCallback: a callback to receive CellInfo. This value cannot be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

requestNetworkScan

Added in API level 28

public NetworkScan requestNetworkScan (NetworkScanRequest request, 
                Executor executor, 
                TelephonyScanManager.NetworkScanCallback callback)

Request a network scan. This method is asynchronous, so the network scan results will be returned by callback. The returned NetworkScan will contain a callback method which can be used to stop the scan.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()) and Manifest.permission.ACCESS_FINE_LOCATION. If the system-wide location switch is off, apps may still call this API, with the following constraints:

1. The app must hold the android.permission.NETWORK_SCAN permission.
2. The app must not supply any specific bands or channels to scan.
3. The app must only specify MCC/MNC pairs that are associated to a SIM in the device.
4. Returned results will have no meaningful info other than signal strength and MCC/MNC info.

Requires Manifest.permission.MODIFY_PHONE_STATE and Manifest.permission.ACCESS_FINE_LOCATION
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
request	NetworkScanRequest: Contains all the RAT with bands/channels that need to be scanned.
executor	Executor: The executor through which the callback should be invoked. Since the scan request may trigger multiple callbacks and they must be invoked in the same order as they are received by the platform, the user should provide an executor which executes tasks one at a time in serial order.
callback	TelephonyScanManager.NetworkScanCallback: Returns network scan results or errors.

Returns
NetworkScan	A NetworkScan obj which contains a callback which can be used to stop the scan.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

requestNetworkScan

Added in API level 33

public NetworkScan requestNetworkScan (int includeLocationData, 
                NetworkScanRequest request, 
                Executor executor, 
                TelephonyScanManager.NetworkScanCallback callback)

Request a network scan. This method is asynchronous, so the network scan results will be returned by callback. The returned NetworkScan will contain a callback method which can be used to stop the scan.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()) and Manifest.permission.ACCESS_FINE_LOCATION if includeLocationData is set to INCLUDE_LOCATION_DATA_FINE. If the system-wide location switch is off, apps may still call this API, with the following constraints:

1. The app must hold the android.permission.NETWORK_SCAN permission.
2. The app must not supply any specific bands or channels to scan.
3. The app must only specify MCC/MNC pairs that are associated to a SIM in the device.
4. Returned results will have no meaningful info other than signal strength and MCC/MNC info.

Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
includeLocationData	int: Specifies if the caller would like to receive location related information. If this parameter is set to INCLUDE_LOCATION_DATA_FINE then the application will be checked for Manifest.permission.ACCESS_FINE_LOCATION permission and available location related information received during network scan will be sent to the caller. Value is INCLUDE_LOCATION_DATA_NONE, INCLUDE_LOCATION_DATA_COARSE, or INCLUDE_LOCATION_DATA_FINE
request	NetworkScanRequest: Contains all the RAT with bands/channels that need to be scanned. This value cannot be null.
executor	Executor: The executor through which the callback should be invoked. Since the scan request may trigger multiple callbacks and they must be invoked in the same order as they are received by the platform, the user should provide an executor which executes tasks one at a time in serial order. This value cannot be null.
callback	TelephonyScanManager.NetworkScanCallback: Returns network scan results or errors. This value cannot be null.

Returns
NetworkScan	A NetworkScan obj which contains a callback which can be used to stop the scan. This value may be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

sendDialerSpecialCode

Added in API level 26

public void sendDialerSpecialCode (String inputCode)

Send the special dialer code. The IPC caller must be the current default dialer or have carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
inputCode	String: The special dialer code to send

Throws
SecurityException	if the caller does not have carrier privileges or is not the current default dialer
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

sendEnvelopeWithStatus

Added in API level 21

public String sendEnvelopeWithStatus (String content)

Send ENVELOPE to the SIM and return the response.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
content	String: String containing SAT/USAT response in hexadecimal format starting with command tag. See TS 102 223 for details.

Returns
String	The APDU response from the ICC card in hexadecimal format with the last 4 bytes being the status word. If the command fails, returns an empty string.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

sendUssdRequest

Added in API level 26

public void sendUssdRequest (String ussdRequest, 
                TelephonyManager.UssdResponseCallback callback, 
                Handler handler)

Sends an Unstructured Supplementary Service Data (USSD) request to the mobile network and informs the caller of the response via the supplied callback.

Carriers define USSD codes which can be sent by the user to request information such as the user's current data balance or minutes balance.

Requires permission: Manifest.permission.CALL_PHONE
Requires Manifest.permission.CALL_PHONE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
ussdRequest	String: the USSD command to be executed.
callback	TelephonyManager.UssdResponseCallback: called by the framework to inform the caller of the result of executing the USSD request (see UssdResponseCallback).
handler	Handler: the Handler to run the request on.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

sendVisualVoicemailSms

Added in API level 26

public void sendVisualVoicemailSms (String number, 
                int port, 
                String text, 
                PendingIntent sentIntent)

Send a visual voicemail SMS. The caller must be the current default dialer. A VisualVoicemailService uses this method to send a command via SMS to the carrier's visual voicemail server. Some examples for carriers using the OMTP standard include activating and deactivating visual voicemail, or requesting the current visual voicemail provisioning status. See the OMTP Visual Voicemail specification for more information on the format of these SMS messages.

Requires Permission: SEND_SMS
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
number	String: The destination number.
port	int: The destination port for data SMS, or 0 for text SMS.
text	String: The message content. For data sms, it will be encoded as a UTF-8 byte stream.
sentIntent	PendingIntent: The sent intent passed to the SmsManager

Throws
SecurityException	if the caller is not the current default dialer
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

See also:

• SmsManager.sendDataMessage(String, String, short, byte[], PendingIntent, PendingIntent)
• SmsManager.sendTextMessage(String, String, String, PendingIntent, PendingIntent)

setAllowedNetworkTypesForReason

Added in API level 33

public void setAllowedNetworkTypesForReason (int reason, 
                long allowedNetworkTypes)

Set the allowed network types of the device and provide the reason triggering the allowed network change.

Requires permission: Manifest.permission.MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()). This can be called for following reasons:

1. Allowed network types control by USER TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_USER
2. Allowed network types control by carrier ALLOWED_NETWORK_TYPES_REASON_CARRIER

This API will result in allowing an intersection of allowed network types for all reasons, including the configuration done through other reasons.
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the TelephonyManager#CAPABILITY_USES_ALLOWED_NETWORK_TYPES_BITMASK feature which can be detected using TelephonyManager.isRadioInterfaceCapabilitySupported(String).

Parameters
reason	int: the reason the allowed network type change is taking place Value is ALLOWED_NETWORK_TYPES_REASON_USER, android.telephony.TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_POWER, ALLOWED_NETWORK_TYPES_REASON_CARRIER, android.telephony.TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_ENABLE_2G, or android.telephony.TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_TEST
allowedNetworkTypes	long: The bitmask of allowed network type Value is either 0 or a combination of NETWORK_TYPE_BITMASK_UNKNOWN, NETWORK_TYPE_BITMASK_GSM, NETWORK_TYPE_BITMASK_GPRS, NETWORK_TYPE_BITMASK_EDGE, NETWORK_TYPE_BITMASK_CDMA, NETWORK_TYPE_BITMASK_1xRTT, NETWORK_TYPE_BITMASK_EVDO_0, NETWORK_TYPE_BITMASK_EVDO_A, NETWORK_TYPE_BITMASK_EVDO_B, NETWORK_TYPE_BITMASK_EHRPD, NETWORK_TYPE_BITMASK_HSUPA, NETWORK_TYPE_BITMASK_HSDPA, NETWORK_TYPE_BITMASK_HSPA, NETWORK_TYPE_BITMASK_HSPAP, NETWORK_TYPE_BITMASK_UMTS, NETWORK_TYPE_BITMASK_TD_SCDMA, NETWORK_TYPE_BITMASK_LTE, NETWORK_TYPE_BITMASK_LTE_CA, NETWORK_TYPE_BITMASK_NR, NETWORK_TYPE_BITMASK_IWLAN, and android.telephony.TelephonyManager.NETWORK_TYPE_BITMASK_IDEN

Throws
IllegalStateException	if the Telephony process is not currently available.
IllegalArgumentException	if invalid AllowedNetworkTypesReason is passed.
SecurityException	if the caller does not have the required privileges or if the
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS. caller tries to use one of the following security-based reasons without Manifest.permission.MODIFY_PHONE_STATE permissions. TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_ENABLE_2G
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

setCallComposerStatus

Added in API level 31

public void setCallComposerStatus (int status)

Set the user-set status for enriched calling with call composer.
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
status	int: user-set status for enriched calling with call composer. If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId() Value is CALL_COMPOSER_STATUS_ON, CALL_COMPOSER_STATUS_OFF, or CALL_COMPOSER_STATUS_BUSINESS_ONLY

Throws
IllegalArgumentException	if requested state is invalid.
SecurityException	if the caller does not have the permission.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

setDataEnabled

Added in API level 26
Deprecated in API level 31

public void setDataEnabled (boolean enable)

This method was deprecated in API level 31.
use setDataEnabledForReason with reason DATA_ENABLED_REASON_USER instead.

Turns mobile data on or off. If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultDataSubscriptionId()

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
enable	boolean: Whether to enable mobile data.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

setDataEnabledForReason

Added in API level 31

public void setDataEnabledForReason (int reason, 
                boolean enabled)

Control of data connection and provide the reason triggering the data connection control. This can be called for following reasons

1. data limit is passed DATA_ENABLED_REASON_POLICY
2. data disabled by carrier DATA_ENABLED_REASON_CARRIER
3. data disabled by user DATA_ENABLED_REASON_USER
4. data disabled due to thermal DATA_ENABLED_REASON_THERMAL

If any of the reason is off, then it will result in bypassing user preference and result in data to be turned off.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultDataSubscriptionId()
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
reason	int: the reason the data enable change is taking place Value is DATA_ENABLED_REASON_USER, DATA_ENABLED_REASON_POLICY, DATA_ENABLED_REASON_CARRIER, or DATA_ENABLED_REASON_THERMAL
enabled	boolean: True if enabling the data, otherwise disabling. Requires Permission: The calling app has carrier privileges (see hasCarrierPrivileges()) if the reason is DATA_ENABLED_REASON_USER or DATA_ENABLED_REASON_CARRIER or the call app has MODIFY_PHONE_STATE irrespective of the reason.

Throws
IllegalStateException	if the Telephony process is not currently available.
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

setForbiddenPlmns

Added in API level 30

public int setForbiddenPlmns (List<String> fplmns)

Replace the contents of the forbidden PLMN SIM file with the provided values. Passing an empty list will clear the contents of the EFfplmn file. If the provided list is shorter than the size of EFfplmn, then the list will be padded up to the file size with 'FFFFFF'. (required by 3GPP TS 31.102 spec 4.2.16) If the list is longer than the size of EFfplmn, then the file will be written from the beginning of the list up to the file size.

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
fplmns	List: a list of PLMNs to be forbidden. This value cannot be null.

Returns
int	number of PLMNs that were successfully written to the SIM FPLMN list. This may be less than the number of PLMNs passed in where the SIM file does not have enough room for all of the values passed in. Return -1 in the event of an unexpected failure

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

setLine1NumberForDisplay

Added in API level 22
Deprecated in API level 33

public boolean setLine1NumberForDisplay (String alphaTag, 
                String number)

This method was deprecated in API level 33.
use SubscriptionManager.setCarrierPhoneNumber(int, String) instead.

Set the line 1 phone number string and its alphatag for the current ICCID for display purpose only, for example, displayed in Phone Status. It won't change the actual MSISDN/MDN. To unset alphatag or number, pass in a null value.

Requires that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
alphaTag	String: alpha-tagging of the dailing nubmer
number	String: The dialing number

Returns
boolean	true if the operation was executed correctly.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

setNetworkSelectionModeAutomatic

Added in API level 28

public void setNetworkSelectionModeAutomatic ()

Sets the network selection mode to automatic.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId()

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

setNetworkSelectionModeManual

Added in API level 30

public boolean setNetworkSelectionModeManual (String operatorNumeric, 
                boolean persistSelection, 
                int ran)

Ask the radio to connect to the input network and change selection mode to manual.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId()

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
operatorNumeric	String: the PLMN ID of the network to select. This value cannot be null.
persistSelection	boolean: whether the selection will persist until reboot. If true, only allows attaching to the selected PLMN until reboot; otherwise, attach to the chosen PLMN and resume normal network selection next time.
ran	int: the initial suggested radio access network type. If registration fails, the RAN is not available after, the RAN is not within the network types specified by the preferred network types, or the value is AccessNetworkConstants.AccessNetworkType.UNKNOWN, modem will select the next best RAN for network registration. Value is AccessNetworkConstants.AccessNetworkType.UNKNOWN, AccessNetworkConstants.AccessNetworkType.GERAN, AccessNetworkConstants.AccessNetworkType.UTRAN, AccessNetworkConstants.AccessNetworkType.EUTRAN, AccessNetworkConstants.AccessNetworkType.CDMA2000, AccessNetworkConstants.AccessNetworkType.IWLAN, or AccessNetworkConstants.AccessNetworkType.NGRAN

Returns
boolean	true on success; false on any failure.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

setNetworkSelectionModeManual

Added in API level 28

public boolean setNetworkSelectionModeManual (String operatorNumeric, 
                boolean persistSelection)

Ask the radio to connect to the input network and change selection mode to manual.

If this object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId()

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
operatorNumeric	String: the PLMN ID of the network to select.
persistSelection	boolean: whether the selection will persist until reboot. If true, only allows attaching to the selected PLMN until reboot; otherwise, attach to the chosen PLMN and resume normal network selection next time.

Returns
boolean	true on success; false on any failure.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

setOperatorBrandOverride

Added in API level 22

public boolean setOperatorBrandOverride (String brand)

Override the branding for the current ICCID. Once set, whenever the SIM is present in the device, the service provider name (SPN) and the operator name will both be replaced by the brand value input. To unset the value, the same function should be called with a null brand value.

Requires that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
brand	String: The brand name to display/set.

Returns
boolean	true if the operation was executed correctly.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

setPreferredNetworkTypeToGlobal

Added in API level 22

public boolean setPreferredNetworkTypeToGlobal ()

Set the preferred network type to global mode which includes NR, LTE, CDMA, EvDo and GSM/WCDMA.

Requires that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Returns
boolean	true on success; false on any failure.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

setPreferredOpportunisticDataSubscription

Added in API level 29

public void setPreferredOpportunisticDataSubscription (int subId, 
                boolean needValidation, 
                Executor executor, 
                Consumer<Integer> callback)

Set preferred opportunistic data subscription id. Switch internet data to preferred opportunistic data subscription id. This api can result in lose of internet connectivity for short period of time while internet data is handed over.

Requires that the calling app has carrier privileges on both primary and secondary subscriptions (see hasCarrierPrivileges()), or has permission MODIFY_PHONE_STATE.
Requires the PackageManager#FEATURE_TELEPHONY_DATA feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
subId	int: which opportunistic subscription SubscriptionManager.getOpportunisticSubscriptions is preferred for cellular data. Pass SubscriptionManager.DEFAULT_SUBSCRIPTION_ID to unset the preference
needValidation	boolean: whether validation is needed before switch happens.
executor	Executor: The executor of where the callback will execute. This value may be null. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread.
callback	Consumer: Callback will be triggered once it succeeds or failed. See the SET_OPPORTUNISTIC_SUB_* constants for more details. Pass null if don't care about the result.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_DATA.

setSignalStrengthUpdateRequest

Added in API level 31

public void setSignalStrengthUpdateRequest (SignalStrengthUpdateRequest request)

Set a SignalStrengthUpdateRequest to receive notification when signal quality measurements breach the specified thresholds. To be notified, set the signal strength update request and then register TelephonyCallback that implements TelephonyCallback.SignalStrengthsListener through registerTelephonyCallback(int, Executor, TelephonyCallback). The notification will arrive through TelephonyCallback.SignalStrengthsListener.onSignalStrengthsChanged(SignalStrength). To stop receiving the notification over the specified thresholds, pass the same SignalStrengthUpdateRequest object to clearSignalStrengthUpdateRequest(android.telephony.SignalStrengthUpdateRequest). System will clean up the SignalStrengthUpdateRequest if the caller process died without calling clearSignalStrengthUpdateRequest(android.telephony.SignalStrengthUpdateRequest). If this TelephonyManager object has been created with createForSubscriptionId(int), applies to the given subId. Otherwise, applies to SubscriptionManager.getDefaultSubscriptionId(). To request for multiple subIds, pass a request object to each TelephonyManager object created with createForSubscriptionId(int).

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges). Note that the thresholds in the request will be used on a best-effort basis; the system may modify requests to multiplex various request sources or to optimize power consumption. The caller should not expect to be notified with the exactly the same thresholds.
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
request	SignalStrengthUpdateRequest: the SignalStrengthUpdateRequest to be set into the System This value cannot be null.

Throws
IllegalStateException	if a new request is set with same subId from the same caller
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

See also:

• clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)

setVisualVoicemailSmsFilterSettings

Added in API level 26

public void setVisualVoicemailSmsFilterSettings (VisualVoicemailSmsFilterSettings settings)

Set the visual voicemail SMS filter settings for the subscription ID pinned to the TelephonyManager. When the filter is enabled, VisualVoicemailService.onSmsReceived(android.telephony.VisualVoicemailService.VisualVoicemailTask, android.telephony.VisualVoicemailSms) will be called when a SMS matching the settings is received. Caller must be the default dialer, system dialer, or carrier visual voicemail app.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
settings	VisualVoicemailSmsFilterSettings: The settings for the filter, or null to disable the filter.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

See also:

• TelecomManager.getDefaultDialerPackage()
• CarrierConfigManager.KEY_CARRIER_VVM_PACKAGE_NAME_STRING_ARRAY

setVoiceMailNumber

Added in API level 22

public boolean setVoiceMailNumber (String alphaTag, 
                String number)

Sets the voice mail number.

Requires that the calling app has carrier privileges (see hasCarrierPrivileges()).
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
alphaTag	String: The alpha tag to display.
number	String: The voicemail number.

Returns
boolean

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

setVoicemailRingtoneUri

Added in API level 26
Deprecated in API level 28

public void setVoicemailRingtoneUri (PhoneAccountHandle phoneAccountHandle, 
                Uri uri)

This method was deprecated in API level 28.
Use Settings.ACTION_CHANNEL_NOTIFICATION_SETTINGS instead.

Sets the per-account voicemail ringtone.

Requires that the calling app is the default dialer, or has carrier privileges (see hasCarrierPrivileges(), or has permission MODIFY_PHONE_STATE.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
phoneAccountHandle	PhoneAccountHandle: The handle for the PhoneAccount for which to set the voicemail ringtone.
uri	Uri: The URI for the ringtone to play when receiving a voicemail from a specific PhoneAccount.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

setVoicemailVibrationEnabled

Added in API level 26
Deprecated in API level 28

public void setVoicemailVibrationEnabled (PhoneAccountHandle phoneAccountHandle, 
                boolean enabled)

This method was deprecated in API level 28.
Use Settings.ACTION_CHANNEL_NOTIFICATION_SETTINGS instead.

Sets the per-account preference whether vibration is enabled for voicemail notifications.

Requires that the calling app is the default dialer, or has carrier privileges (see hasCarrierPrivileges(), or has permission MODIFY_PHONE_STATE.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
phoneAccountHandle	PhoneAccountHandle: The handle for the PhoneAccount for which to set the voicemail vibration setting.
enabled	boolean: Whether to enable or disable vibration for voicemail notifications from a specific PhoneAccount.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

switchMultiSimConfig

Added in API level 29

public void switchMultiSimConfig (int numOfSims)

Switch configs to enable multi-sim or switch back to single-sim

Requires Permission: MODIFY_PHONE_STATE or that the calling app has carrier privileges (see hasCarrierPrivileges()). Note: with only carrier privileges, it is not allowed to switch from multi-sim to single-sim
Requires Manifest.permission.MODIFY_PHONE_STATE
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
numOfSims	int: number of live SIMs we want to switch to

Throws
	android.os.RemoteException
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_SUBSCRIPTION.

unregisterTelephonyCallback

Added in API level 31

public void unregisterTelephonyCallback (TelephonyCallback callback)

Unregister an existing TelephonyCallback.

Parameters
callback	TelephonyCallback: The TelephonyCallback object to unregister. This value cannot be null.

updateAvailableNetworks

Added in API level 29

public void updateAvailableNetworks (List<AvailableNetworkInfo> availableNetworks, 
                Executor executor, 
                Consumer<Integer> callback)

Update availability of a list of networks in the current location. This api should be called to inform OpportunisticNetwork Service about the availability of a network at the current location. This information will be used by OpportunisticNetwork service to enable modem stack and to attach to the network. If an empty list is passed, it is assumed that no network is available and will result in disabling the modem stack to save power. This api do not switch internet data once network attach is completed. Use TelephonyManager.setPreferredOpportunisticDataSubscription to switch internet data after network attach is complete. Requires that the calling app has carrier privileges on both primary and secondary subscriptions (see hasCarrierPrivileges()), or has permission MODIFY_PHONE_STATE.
Requires the PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
availableNetworks	List: is a list of available network information. This value cannot be null.
executor	Executor: The executor of where the callback will execute. This value may be null. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread.
callback	Consumer: Callback will be triggered once it succeeds or failed. Value is UPDATE_AVAILABLE_NETWORKS_SUCCESS, UPDATE_AVAILABLE_NETWORKS_UNKNOWN_FAILURE, UPDATE_AVAILABLE_NETWORKS_ABORTED, UPDATE_AVAILABLE_NETWORKS_INVALID_ARGUMENTS, UPDATE_AVAILABLE_NETWORKS_NO_CARRIER_PRIVILEGE, UPDATE_AVAILABLE_NETWORKS_DISABLE_MODEM_FAIL, UPDATE_AVAILABLE_NETWORKS_ENABLE_MODEM_FAIL, UPDATE_AVAILABLE_NETWORKS_MULTIPLE_NETWORKS_NOT_SUPPORTED, UPDATE_AVAILABLE_NETWORKS_NO_OPPORTUNISTIC_SUB_AVAILABLE, UPDATE_AVAILABLE_NETWORKS_REMOTE_SERVICE_EXCEPTION, UPDATE_AVAILABLE_NETWORKS_SERVICE_IS_DISABLED, or android.telephony.TelephonyManager.UPDATE_AVAILABLE_NETWORKS_SIM_PORT_NOT_AVAILABLE This value may be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_RADIO_ACCESS.

uploadCallComposerPicture

Added in API level 31

public void uploadCallComposerPicture (InputStream pictureToUpload, 
                String contentType, 
                Executor executor, 
                OutcomeReceiver<ParcelUuid, TelephonyManager.CallComposerException> callback)

Uploads a picture to the carrier network for use with call composer. This method allows a dialer app to upload a picture to the carrier network that can then later be attached to an outgoing call. In order to attach the picture to a call, use the ParcelUuid returned from callback upon successful upload as the value to TelecomManager.EXTRA_OUTGOING_PICTURE. This functionality is only available to the app filling the RoleManager.ROLE_DIALER role on the device. This functionality is only available when CarrierConfigManager.KEY_SUPPORTS_CALL_COMPOSER_BOOL is set to true in the bundle returned from getCarrierConfig().
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
pictureToUpload	InputStream: An InputStream that supplies the bytes representing the picture to upload. The client bears responsibility for closing this stream after callback is called with success or failure. Additionally, if the stream supplies more bytes than the return value of getMaximumCallComposerPictureSize(), the upload will be aborted and the callback will be called with an exception containing CallComposerException.ERROR_FILE_TOO_LARGE. This value cannot be null.
contentType	String: The MIME type of the picture you're uploading (e.g. image/jpeg). The list of acceptable content types can be found at 3GPP TS 26.141 sections 4.2 and 4.3. This value cannot be null.
executor	Executor: The Executor on which the pictureToUpload stream will be read, as well as on which the callback will be called. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread. This value cannot be null.
callback	OutcomeReceiver: A callback called when the upload operation terminates, either in success or in error. This value cannot be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

uploadCallComposerPicture

Added in API level 31

public void uploadCallComposerPicture (Path pictureToUpload, 
                String contentType, 
                Executor executor, 
                OutcomeReceiver<ParcelUuid, TelephonyManager.CallComposerException> callback)

Uploads a picture to the carrier network for use with call composer.
Requires the PackageManager#FEATURE_TELEPHONY_CALLING feature which can be detected using PackageManager.hasSystemFeature(String).

Parameters
pictureToUpload	Path: Path to a local file containing the picture to upload. This value cannot be null.
contentType	String: The MIME type of the picture you're uploading (e.g. image/jpeg) This value cannot be null.
executor	Executor: The Executor on which the pictureToUpload file will be read from disk, as well as on which callback will be called. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread. This value cannot be null.
callback	OutcomeReceiver: A callback called when the upload operation terminates, either in success or in error. This value cannot be null.

Throws
UnsupportedOperationException	If the device does not have PackageManager.FEATURE_TELEPHONY_CALLING.

See also:

• uploadCallComposerPicture(InputStream, String, Executor, OutcomeReceiver)