# SmsManager Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) Deprecated in[API level 4](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) # SmsManager *** ** * ** *** Kotlin\|[Java](https://developer.android.com/reference/android/telephony/gsm/SmsManager "View this page in Java") ``` class SmsManager ``` |---|----------------------------------------------------------------------------------------------------------------------| | [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) || | ↳ | [android.telephony.gsm.SmsManager](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#) | *** ** * ** *** | **This class was deprecated in API level 4.** | | Replaced by android.telephony.SmsManager that supports both GSM and CDMA. Manages SMS operations such as sending data, text, and pdu SMS messages. Get this object by calling the static method SmsManager.getDefault(). ## Summary | Constants || |----------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [RESULT_ERROR_GENERIC_FAILURE](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#RESULT_ERROR_GENERIC_FAILURE:kotlin.Int) Generic failure cause | | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [RESULT_ERROR_NO_SERVICE](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#RESULT_ERROR_NO_SERVICE:kotlin.Int) Failed because service is currently unavailable | | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [RESULT_ERROR_NULL_PDU](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#RESULT_ERROR_NULL_PDU:kotlin.Int) Failed because no pdu provided | | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [RESULT_ERROR_RADIO_OFF](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#RESULT_ERROR_RADIO_OFF:kotlin.Int) Failed because radio was explicitly turned off | | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_ON_SIM_FREE](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#STATUS_ON_SIM_FREE:kotlin.Int) Free space (TS 51.011 10.5.3). | | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_ON_SIM_READ](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#STATUS_ON_SIM_READ:kotlin.Int) Received and read (TS 51.011 10.5.3). | | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_ON_SIM_SENT](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#STATUS_ON_SIM_SENT:kotlin.Int) Stored and sent (TS 51.011 10.5.3). | | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_ON_SIM_UNREAD](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#STATUS_ON_SIM_UNREAD:kotlin.Int) Received and unread (TS 51.011 10.5.3). | | static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_ON_SIM_UNSENT](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#STATUS_ON_SIM_UNSENT:kotlin.Int) Stored and unsent (TS 51.011 10.5.3). | | Public methods || |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [ArrayList](https://developer.android.com/reference/kotlin/java/util/ArrayList.html#)\<[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!\>! | [divideMessage](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#divideMessage(kotlin.String))`(`text:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`)` Divide a text message into several messages, none bigger than the maximum SMS message size. | | static[SmsManager](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#)! | [getDefault](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#getDefault())`()` Get the default instance of the SmsManager | | [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [sendDataMessage](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#sendDataMessage(kotlin.String,%20kotlin.String,%20kotlin.Short,%20kotlin.ByteArray,%20android.app.PendingIntent,%20android.app.PendingIntent))`(`destinationAddress:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `scAddress:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `destinationPort:` `[Short](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-short/index.html)`, `data:` `[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/index.html)!`, `sentIntent:` `[PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!`, `deliveryIntent:` `[PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!`)` Send a data based SMS to a specific application port. | | [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [sendMultipartTextMessage](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#sendMultipartTextMessage(kotlin.String,%20kotlin.String,%20java.util.ArrayList,%20java.util.ArrayList,%20java.util.ArrayList))`(`destinationAddress:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `scAddress:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `parts:` `[ArrayList](https://developer.android.com/reference/kotlin/java/util/ArrayList.html#)<[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!>!`, `sentIntents:` `[ArrayList](https://developer.android.com/reference/kotlin/java/util/ArrayList.html#)<[PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!>!`, `deliveryIntents:` `[ArrayList](https://developer.android.com/reference/kotlin/java/util/ArrayList.html#)<[PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!>!`)` Send a multi-part text based SMS. | | [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [sendTextMessage](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#sendTextMessage(kotlin.String,%20kotlin.String,%20kotlin.String,%20android.app.PendingIntent,%20android.app.PendingIntent))`(`destinationAddress:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `scAddress:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `text:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `sentIntent:` `[PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!`, `deliveryIntent:` `[PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!`)` Send a text based SMS. | ## Constants ### RESULT_ERROR_GENERIC_FAILURE Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val RESULT_ERROR_GENERIC_FAILURE: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Generic failure cause Value: 1 ### RESULT_ERROR_NO_SERVICE Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val RESULT_ERROR_NO_SERVICE: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Failed because service is currently unavailable Value: 4 ### RESULT_ERROR_NULL_PDU Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val RESULT_ERROR_NULL_PDU: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Failed because no pdu provided Value: 3 ### RESULT_ERROR_RADIO_OFF Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val RESULT_ERROR_RADIO_OFF: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Failed because radio was explicitly turned off Value: 2 ### STATUS_ON_SIM_FREE Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val STATUS_ON_SIM_FREE: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Free space (TS 51.011 10.5.3). Value: 0 ### STATUS_ON_SIM_READ Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val STATUS_ON_SIM_READ: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Received and read (TS 51.011 10.5.3). Value: 1 ### STATUS_ON_SIM_SENT Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val STATUS_ON_SIM_SENT: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Stored and sent (TS 51.011 10.5.3). Value: 5 ### STATUS_ON_SIM_UNREAD Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val STATUS_ON_SIM_UNREAD: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Received and unread (TS 51.011 10.5.3). Value: 3 ### STATUS_ON_SIM_UNSENT Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val STATUS_ON_SIM_UNSENT: Int ``` **Deprecated:** *Use android.telephony.SmsManager.* Stored and unsent (TS 51.011 10.5.3). Value: 7 ## Public methods ### divideMessage Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` fun divideMessage(text: String!): ArrayList! ``` **Deprecated:** *Use android.telephony.SmsManager.* Divide a text message into several messages, none bigger than the maximum SMS message size. | Parameters || |--------|---------------------------------------------------------------------------------------------------------------------------| | `text` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:the original message. Must not be null. | | Return || |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------| | [ArrayList](https://developer.android.com/reference/kotlin/java/util/ArrayList.html#)<[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!>! | an`ArrayList`of strings that, in order, comprise the original message | ### getDefault Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static fun getDefault(): SmsManager! ``` **Deprecated:** *Use android.telephony.SmsManager.* Get the default instance of the SmsManager | Return || |-------------------------------------------------------------------------------------------------|----------------------------------------| | [SmsManager](https://developer.android.com/reference/kotlin/android/telephony/gsm/SmsManager#)! | the default instance of the SmsManager | ### sendDataMessage Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` fun sendDataMessage(     destinationAddress: String!,     scAddress: String!,     destinationPort: Short,     data: ByteArray!,     sentIntent: PendingIntent!,     deliveryIntent: PendingIntent! ): Unit ``` **Deprecated:** *Use android.telephony.SmsManager.* Send a data based SMS to a specific application port. | Parameters || |----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `destinationAddress` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:the address to send the message to | | `scAddress` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:is the service center address or null to use the current default SMSC | | `destinationPort` | [Short](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-short/index.html):the port to deliver the message to | | `data` | [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/index.html)!:the body of the message to send | | `sentIntent` | [PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!:if not NULL this`PendingIntent`is broadcast when the message is sucessfully sent, or failed. The result code will be`Activity.RESULT_OK`` for success, or one of these errors: ``RESULT_ERROR_GENERIC_FAILURE`` ``RESULT_ERROR_RADIO_OFF`` ``RESULT_ERROR_NULL_PDU``. The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applicaitons, which cause smaller number of SMS to be sent in checking period.` | | `deliveryIntent` | [PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!:if not NULL this`PendingIntent`is broadcast when the message is delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu"). | | Exceptions || |--------------------------------------|-----------------------------------------| | `java.lang.IllegalArgumentException` | if destinationAddress or data are empty | ### sendMultipartTextMessage Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` fun sendMultipartTextMessage(     destinationAddress: String!,     scAddress: String!,     parts: ArrayList!,     sentIntents: ArrayList!,     deliveryIntents: ArrayList! ): Unit ``` **Deprecated:** *Use android.telephony.SmsManager.* Send a multi-part text based SMS. The callee should have already divided the message into correctly sized parts by calling`divideMessage`. | Parameters || |----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `destinationAddress` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:the address to send the message to | | `scAddress` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:is the service center address or null to use the current default SMSC | | `parts` | [ArrayList](https://developer.android.com/reference/kotlin/java/util/ArrayList.html#)\<[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!\>!:an`ArrayList`of strings that, in order, comprise the original message | | `sentIntents` | [ArrayList](https://developer.android.com/reference/kotlin/java/util/ArrayList.html#)\<[PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!\>!:if not null, an`ArrayList`of`PendingIntent`s (one for each message part) that is broadcast when the corresponding message part has been sent. The result code will be`Activity.RESULT_OK`` for success, or one of these errors: ``RESULT_ERROR_GENERIC_FAILURE`` ``RESULT_ERROR_RADIO_OFF`` ``RESULT_ERROR_NULL_PDU``. The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applicaitons, which cause smaller number of SMS to be sent in checking period.` | | `deliveryIntents` | [ArrayList](https://developer.android.com/reference/kotlin/java/util/ArrayList.html#)\<[PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!\>!:if not null, an`ArrayList`of`PendingIntent`s (one for each message part) that is broadcast when the corresponding message part has been delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu"). | | Exceptions || |--------------------------------------|-----------------------------------------| | `java.lang.IllegalArgumentException` | if destinationAddress or data are empty | ### sendTextMessage Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` fun sendTextMessage(     destinationAddress: String!,     scAddress: String!,     text: String!,     sentIntent: PendingIntent!,     deliveryIntent: PendingIntent! ): Unit ``` **Deprecated:** *Use android.telephony.SmsManager.* Send a text based SMS. | Parameters || |----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `destinationAddress` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:the address to send the message to | | `scAddress` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:is the service center address or null to use the current default SMSC | | `text` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:the body of the message to send | | `sentIntent` | [PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!:if not NULL this`PendingIntent`is broadcast when the message is successfully sent, or failed. The result code will be`Activity.RESULT_OK`` for success, or one of these errors: ``RESULT_ERROR_GENERIC_FAILURE`` ``RESULT_ERROR_RADIO_OFF`` ``RESULT_ERROR_NULL_PDU``. The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applications, which cause smaller number of SMS to be sent in checking period.` | | `deliveryIntent` | [PendingIntent](https://developer.android.com/reference/kotlin/android/app/PendingIntent.html#)!:if not NULL this`PendingIntent`is broadcast when the message is delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu"). | | Exceptions || |--------------------------------------|-----------------------------------------| | `java.lang.IllegalArgumentException` | if destinationAddress or text are empty |