# Contacts.Phones

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# Phones

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/provider/Contacts.Phones "View this page in Java")  

```
class Phones : BaseColumns, Contacts.PeopleColumns, Contacts.PhonesColumns
```

|---|----------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                       ||
| ↳ | [android.provider.Contacts.Phones](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#) |

*** ** * ** ***

| **This class was deprecated in API level 5.**
|
| see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)

This table stores phone numbers and a reference to the person that the contact method belongs to. Phone numbers are stored separately from other contact methods to make caller ID lookup more efficient.

## Summary

|                                                                                                                                                                                                Constants                                                                                                                                                                                                 ||
|----------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [CONTENT_ITEM_TYPE](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#CONTENT_ITEM_TYPE:kotlin.String) The MIME type of a[CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#CONTENT_URI:android.net.Uri)subdirectory of a single phone. |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [CONTENT_TYPE](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#CONTENT_TYPE:kotlin.String) The MIME type of[CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#CONTENT_URI:android.net.Uri)providing a directory of phones.            |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [DEFAULT_SORT_ORDER](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#DEFAULT_SORT_ORDER:kotlin.String) The default sort order for this table                                                                                                                                     |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [PERSON_ID](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#PERSON_ID:kotlin.String) The ID of the person this phone number is assigned to.                                                                                                                                      |

| Inherited constants ||
|---|---|
| From class[PeopleColumns](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns) |----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [CUSTOM_RINGTONE](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#CUSTOM_RINGTONE:kotlin.String) <br /> A custom ringtone associated with a person. Not always present. Type: TEXT (URI to the ringtone) <br />                                                                              | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [DISPLAY_NAME](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#DISPLAY_NAME:kotlin.String) <br /> The display name. If name is not null name, else if number is not null number, else if email is not null email. Type: TEXT <br />                                                          | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [LAST_TIME_CONTACTED](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#LAST_TIME_CONTACTED:kotlin.String) <br /> The last time a person was contacted. Type: INTEGER <br />                                                                                                                   | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [NAME](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#NAME:kotlin.String) <br /> The person's name. Type: TEXT <br />                                                                                                                                                                       | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [NOTES](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#NOTES:kotlin.String) <br /> Notes about the person. Type: TEXT <br />                                                                                                                                                                | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [PHONETIC_NAME](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#PHONETIC_NAME:kotlin.String) <br /> Phonetic equivalent of the person's name, in a locale-dependent character set (e.g. hiragana for Japanese). Used for pronunciation and/or collation in some languages. Type: TEXT <br /> | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [PHOTO_VERSION](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#PHOTO_VERSION:kotlin.String) <br /> The server version of the photo Type: TEXT (the version number portion of the photo URI) <br />                                                                                          | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [SEND_TO_VOICEMAIL](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#SEND_TO_VOICEMAIL:kotlin.String) <br /> Whether the person should always be sent to voicemail. Not always present. Type: INTEGER (0 for false, 1 for true) <br />                                                        | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [STARRED](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#STARRED:kotlin.String) <br /> Is the contact starred? Type: INTEGER (boolean) <br />                                                                                                                                               | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [TIMES_CONTACTED](https://developer.android.com/reference/kotlin/android/provider/Contacts.PeopleColumns#TIMES_CONTACTED:kotlin.String) <br /> The number of times a person has been contacted Type: INTEGER <br />                                                                                                                 | ||
| From class[PhonesColumns](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns) |----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [ISPRIMARY](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#ISPRIMARY:kotlin.String) <br /> Whether this is the primary phone number Type: INTEGER (if set, non-0 means true) <br />  | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [LABEL](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#LABEL:kotlin.String) <br /> The user provided label for the phone number, only used if TYPE is TYPE_CUSTOM. Type: TEXT <br /> | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [NUMBER](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#NUMBER:kotlin.String) <br /> The phone number as the user entered it. Type: TEXT <br />                                      | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [NUMBER_KEY](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#NUMBER_KEY:kotlin.String) <br /> The normalized phone number Type: TEXT <br />                                           | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [TYPE](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE:kotlin.String) <br /> The type of the the phone number. Type: INTEGER (one of the constants below) <br />                 | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_CUSTOM](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE_CUSTOM:kotlin.Int) <br />                                                                                          | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_FAX_HOME](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE_FAX_HOME:kotlin.Int) <br />                                                                                      | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_FAX_WORK](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE_FAX_WORK:kotlin.Int) <br />                                                                                      | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_HOME](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE_HOME:kotlin.Int) <br />                                                                                              | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_MOBILE](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE_MOBILE:kotlin.Int) <br />                                                                                          | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_OTHER](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE_OTHER:kotlin.Int) <br />                                                                                            | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_PAGER](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE_PAGER:kotlin.Int) <br />                                                                                            | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_WORK](https://developer.android.com/reference/kotlin/android/provider/Contacts.PhonesColumns#TYPE_WORK:kotlin.Int) <br />                                                                                              | ||
| From class[BaseColumns](https://developer.android.com/reference/kotlin/android/provider/BaseColumns) |----------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [_COUNT](https://developer.android.com/reference/kotlin/android/provider/BaseColumns#_COUNT:kotlin.String) <br /> The count of rows in a directory. Type: INTEGER <br /> | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [_ID](https://developer.android.com/reference/kotlin/android/provider/BaseColumns#_ID:kotlin.String) <br /> The unique ID for a row. Type: INTEGER (long) <br />         | ||

|                                                                                                                                                                                                                                                                                                                                                                                                      Public methods                                                                                                                                                                                                                                                                                                                                                                                                      ||
|------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| static[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)! | [getDisplayLabel](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#getDisplayLabel(android.content.Context,%20kotlin.Int,%20kotlin.CharSequence))`(`context:` `[Context](https://developer.android.com/reference/kotlin/android/content/Context.html#)!`, `type:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`, `label:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`)` <br />                                                                                                                                                                                                                  |
| static[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)! | [getDisplayLabel](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#getDisplayLabel(android.content.Context,%20kotlin.Int,%20kotlin.CharSequence,%20kotlin.Array))`(`context:` `[Context](https://developer.android.com/reference/kotlin/android/content/Context.html#)!`, `type:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`, `label:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`, `labelArray:` `[Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!>!`)` <br /> |

|                                                                                                                                    Properties                                                                                                                                     ||
|------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| static[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)! | [CONTENT_FILTER_URL](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#CONTENT_FILTER_URL:android.net.Uri) The content:// style URL for filtering phone numbers |
| static[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)! | [CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#CONTENT_URI:android.net.Uri) The content:// style URL for this table                            |

## Constants

### CONTENT_ITEM_TYPE

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val CONTENT_ITEM_TYPE: String
```

**Deprecated:** *see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)*

The MIME type of a[CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#CONTENT_URI:android.net.Uri)subdirectory of a single phone.  

    Value: "vnd.android.cursor.item/phone"

### CONTENT_TYPE

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val CONTENT_TYPE: String
```

**Deprecated:** *see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)*

The MIME type of[CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/Contacts.Phones#CONTENT_URI:android.net.Uri)providing a directory of phones.  

    Value: "vnd.android.cursor.dir/phone"

### DEFAULT_SORT_ORDER

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val DEFAULT_SORT_ORDER: String
```

**Deprecated:** *see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)*

The default sort order for this table  

    Value: "name ASC"

### PERSON_ID

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val PERSON_ID: String
```

**Deprecated:** *see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)*

The ID of the person this phone number is assigned to.

Type: INTEGER (long)  

    Value: "person"

## Public methods

### getDisplayLabel

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static fun getDisplayLabel(
    context: Context!, 
    type: Int, 
    label: CharSequence!
): CharSequence!
```

**Deprecated:** *see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)*  

### getDisplayLabel

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static fun getDisplayLabel(
    context: Context!, 
    type: Int, 
    label: CharSequence!, 
    labelArray: Array<CharSequence!>!
): CharSequence!
```

**Deprecated:** *see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)*

## Properties

### CONTENT_FILTER_URL

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val CONTENT_FILTER_URL: Uri!
```

**Deprecated:** *see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)*

The content:// style URL for filtering phone numbers  

### CONTENT_URI

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val CONTENT_URI: Uri!
```

**Deprecated:** *see[android.provider.ContactsContract](https://developer.android.com/reference/kotlin/android/provider/ContactsContract)*

The content:// style URL for this table