Added in API level 19

Telephony.Sms

Kotlin |Java

public static final class Telephony.Sms
extends Object implements BaseColumns, Telephony.TextBasedSmsColumns

java.lang.Object
↳	android.provider.Telephony.Sms

Contains all text-based SMS messages.

Summary

Nested classes
`class`	`Telephony.Sms.Conversations` Contains a view of SMS conversations (also referred to as threads).
`class`	`Telephony.Sms.Draft` Contains all draft text-based SMS messages in the SMS app.
`class`	`Telephony.Sms.Inbox` Contains all text-based SMS messages in the SMS app inbox.
`class`	`Telephony.Sms.Intents` Contains constants for SMS related Intents that are broadcast.
`class`	`Telephony.Sms.Outbox` Contains all pending outgoing text-based SMS messages.
`class`	`Telephony.Sms.Sent` Contains all sent text-based SMS messages in the SMS app.

Constants
`String`	`DEFAULT_SORT_ORDER` The default sort order for this table.

Inherited constants

From interface android.provider.BaseColumns

`String`	`_COUNT` The count of rows in a directory.
`String`	`_ID` The unique ID for a row.

From interface android.provider.Telephony.TextBasedSmsColumns

`String`	`ADDRESS` The address of the other party.
`String`	`BODY` The body of the message.
`String`	`CREATOR` The identity of the sender of a sent message.
`String`	`DATE` The date the message was received.
`String`	`DATE_SENT` The date the message was sent.
`String`	`ERROR_CODE` Error code associated with sending or receiving this message Type: INTEGER
`String`	`LOCKED` Is the message locked? Type: INTEGER (boolean)
`int`	`MESSAGE_TYPE_ALL` Message type: all messages.
`int`	`MESSAGE_TYPE_DRAFT` Message type: drafts.
`int`	`MESSAGE_TYPE_FAILED` Message type: failed outgoing message.
`int`	`MESSAGE_TYPE_INBOX` Message type: inbox.
`int`	`MESSAGE_TYPE_OUTBOX` Message type: outbox.
`int`	`MESSAGE_TYPE_QUEUED` Message type: queued to send later.
`int`	`MESSAGE_TYPE_SENT` Message type: sent messages.
`String`	`PERSON` The ID of the sender of the conversation, if present.
`String`	`PROTOCOL` The protocol identifier code.
`String`	`READ` Has the message been read? Type: INTEGER (boolean)
`String`	`REPLY_PATH_PRESENT` Is the `TP-Reply-Path` flag set? Type: BOOLEAN
`String`	`SEEN` Has the message been seen by the user? The "seen" flag determines whether we need to show a notification.
`String`	`SERVICE_CENTER` The service center (SC) through which to send the message, if present.
`String`	`STATUS` `TP-Status` value for the message, or -1 if no status has been received.
`int`	`STATUS_COMPLETE` TP-Status: complete.
`int`	`STATUS_FAILED` TP-Status: failed.
`int`	`STATUS_NONE` TP-Status: no status received.
`int`	`STATUS_PENDING` TP-Status: pending.
`String`	`SUBJECT` The subject of the message, if present.
`String`	`SUBSCRIPTION_ID` The subscription to which the message belongs to.
`String`	`THREAD_ID` The thread ID of the message.
`String`	`TYPE` The type of message.

Fields
`public static final Uri`	`CONTENT_URI` The `content://` style URL for this table.

Public methods
`static String`	`getDefaultSmsPackage(Context context)` Used to determine the currently configured default SMS package.

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

DEFAULT_SORT_ORDER

Added in API level 19

 public static final String DEFAULT_SORT_ORDER

The default sort order for this table.

Constant Value: "date DESC"

Fields

CONTENT_URI

Added in API level 19

 public static final Uri CONTENT_URI

The content:// style URL for this table.

Public methods

getDefaultSmsPackage

Added in API level 19

 public static String getDefaultSmsPackage (Context context)

Used to determine the currently configured default SMS package.

As of Android 11 apps will need specific permission to query other packages. To use this method an app must include in their AndroidManifest:

<queries>    <intent>      <action android:name="android.provider.Telephony.SMS_DELIVER"/>    </intent>  </queries>

Which will allow them to query packages which declare intent filters that include the Telephony.Sms.Intents.SMS_DELIVER_ACTION intent.

Parameters
`context`	`Context`: context of the requesting application

Returns
`String`	package name for the default SMS package or null

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2025-02-10 UTC.

X
Follow @AndroidDev on X
YouTube
Check out Android Developers on YouTube
LinkedIn
Connect with the Android Developers community on LinkedIn

Telephony.Sms

Summary

Nested classes

Constants

Inherited constants

Fields

Public methods

Inherited methods

Constants

DEFAULT_SORT_ORDER

Fields

CONTENT_URI

Public methods

getDefaultSmsPackage