# ContactsContract.CommonDataKinds.Phone

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

# Phone

*** ** * ** ***

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

```
class Phone : ContactsContract.CommonDataKinds.CommonColumns, ContactsContract.DataColumnsWithJoins
```

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

A data kind representing a telephone number.

You can use all columns defined for[ContactsContract.Data](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.Data)as well as the following aliases.

## Column aliases

|  Type  |                                                                    Alias                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     Data column                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     ||
|--------|---------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| String | [NUMBER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#NUMBER:kotlin.String)       | [DATA1](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.DataColumns#DATA1:kotlin.String) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| int    | [TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#TYPE:kotlin.String)   | [DATA2](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.DataColumns#DATA2:kotlin.String) | Allowed values are: <br /> - [TYPE_CUSTOM](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.BaseTypes#TYPE_CUSTOM:kotlin.Int). Put the actual type in[LABEL](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#LABEL:kotlin.String). - [TYPE_HOME](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_HOME:kotlin.Int) - [TYPE_MOBILE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_MOBILE:kotlin.Int) - [TYPE_WORK](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_WORK:kotlin.Int) - [TYPE_FAX_WORK](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_FAX_WORK:kotlin.Int) - [TYPE_FAX_HOME](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_FAX_HOME:kotlin.Int) - [TYPE_PAGER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_PAGER:kotlin.Int) - [TYPE_OTHER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_OTHER:kotlin.Int) - [TYPE_CALLBACK](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_CALLBACK:kotlin.Int) - [TYPE_CAR](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_CAR:kotlin.Int) - [TYPE_COMPANY_MAIN](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_COMPANY_MAIN:kotlin.Int) - [TYPE_ISDN](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_ISDN:kotlin.Int) - [TYPE_MAIN](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_MAIN:kotlin.Int) - [TYPE_OTHER_FAX](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_OTHER_FAX:kotlin.Int) - [TYPE_RADIO](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_RADIO:kotlin.Int) - [TYPE_TELEX](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_TELEX:kotlin.Int) - [TYPE_TTY_TDD](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_TTY_TDD:kotlin.Int) - [TYPE_WORK_MOBILE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_WORK_MOBILE:kotlin.Int) - [TYPE_WORK_PAGER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_WORK_PAGER:kotlin.Int) - [TYPE_ASSISTANT](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_ASSISTANT:kotlin.Int) - [TYPE_MMS](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_MMS:kotlin.Int) <br /> |
| String | [LABEL](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#LABEL:kotlin.String) | [DATA3](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.DataColumns#DATA3:kotlin.String) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

## 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/ContactsContract.CommonDataKinds.Phone#CONTENT_ITEM_TYPE:kotlin.String) MIME type used when storing this in data table.                                                                                                                                                                             |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [CONTENT_TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_TYPE:kotlin.String) The MIME type of[CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_URI:android.net.Uri)providing a directory of phones.                                     |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [EXTRA_ADDRESS_BOOK_INDEX](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#EXTRA_ADDRESS_BOOK_INDEX:kotlin.String) Add this query parameter to a URI to get back row counts grouped by the address book index as cursor extras.                                                                                                  |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [EXTRA_ADDRESS_BOOK_INDEX_COUNTS](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#EXTRA_ADDRESS_BOOK_INDEX_COUNTS:kotlin.String) The array of group counts for the corresponding group.                                                                                                                                          |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [EXTRA_ADDRESS_BOOK_INDEX_TITLES](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#EXTRA_ADDRESS_BOOK_INDEX_TITLES:kotlin.String) The array of address book index titles, which are returned in the same order as the data in the cursor.                                                                                         |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [NORMALIZED_NUMBER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#NORMALIZED_NUMBER:kotlin.String) The phone number's E164 representation.                                                                                                                                                                                     |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [NUMBER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#NUMBER:kotlin.String) The phone number as the user entered it.                                                                                                                                                                                                          |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [SEARCH_DISPLAY_NAME_KEY](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#SEARCH_DISPLAY_NAME_KEY:kotlin.String) A boolean query parameter that can be used with[CONTENT_FILTER_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI:android.net.Uri). |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [SEARCH_PHONE_NUMBER_KEY](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#SEARCH_PHONE_NUMBER_KEY:kotlin.String) A boolean query parameter that can be used with[CONTENT_FILTER_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI:android.net.Uri). |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_ASSISTANT](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_ASSISTANT:kotlin.Int) <br />                                                                                                                                                                                                                               |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_CALLBACK](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_CALLBACK:kotlin.Int) <br />                                                                                                                                                                                                                                 |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_CAR](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_CAR:kotlin.Int) <br />                                                                                                                                                                                                                                           |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_COMPANY_MAIN](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_COMPANY_MAIN:kotlin.Int) <br />                                                                                                                                                                                                                         |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_FAX_HOME](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_FAX_HOME:kotlin.Int) <br />                                                                                                                                                                                                                                 |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_FAX_WORK](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_FAX_WORK:kotlin.Int) <br />                                                                                                                                                                                                                                 |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_HOME](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_HOME:kotlin.Int) <br />                                                                                                                                                                                                                                         |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_ISDN](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_ISDN:kotlin.Int) <br />                                                                                                                                                                                                                                         |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_MAIN](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_MAIN:kotlin.Int) <br />                                                                                                                                                                                                                                         |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_MMS](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_MMS:kotlin.Int) <br />                                                                                                                                                                                                                                           |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_MOBILE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_MOBILE:kotlin.Int) <br />                                                                                                                                                                                                                                     |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_OTHER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_OTHER:kotlin.Int) <br />                                                                                                                                                                                                                                       |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_OTHER_FAX](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_OTHER_FAX:kotlin.Int) <br />                                                                                                                                                                                                                               |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_PAGER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_PAGER:kotlin.Int) <br />                                                                                                                                                                                                                                       |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_RADIO](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_RADIO:kotlin.Int) <br />                                                                                                                                                                                                                                       |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_TELEX](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_TELEX:kotlin.Int) <br />                                                                                                                                                                                                                                       |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_TTY_TDD](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_TTY_TDD:kotlin.Int) <br />                                                                                                                                                                                                                                   |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_WORK](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_WORK:kotlin.Int) <br />                                                                                                                                                                                                                                         |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_WORK_MOBILE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_WORK_MOBILE:kotlin.Int) <br />                                                                                                                                                                                                                           |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)       | [TYPE_WORK_PAGER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#TYPE_WORK_PAGER:kotlin.Int) <br />                                                                                                                                                                                                                             |

| Inherited constants ||
|---|---|
| From class[CommonColumns](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns) |----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [DATA](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#DATA:kotlin.String) <br /> The data for the contact method. Type: TEXT <br />                     | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [LABEL](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#LABEL:kotlin.String) <br /> The user defined label for the the contact method. Type: TEXT <br /> | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#TYPE:kotlin.String) <br /> The type of data, for example Home or Work. Type: INTEGER <br />       | ||
| From class[BaseTypes](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.BaseTypes) |----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_CUSTOM](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.BaseTypes#TYPE_CUSTOM:kotlin.Int) <br /> A custom type. The custom label should be supplied by user. <br /> | ||

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             Public methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              ||
|------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| static[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)! | [getTypeLabel](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#getTypeLabel(android.content.res.Resources,%20kotlin.Int,%20kotlin.CharSequence))`(`res:` `[Resources](https://developer.android.com/reference/kotlin/android/content/res/Resources.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)?`)` Return a[CharSequence](https://developer.android.com/reference/kotlin/java/lang/CharSequence.html#)that best describes the given type, possibly substituting the given[LABEL](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#LABEL:kotlin.String)value for[TYPE_CUSTOM](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.BaseTypes#TYPE_CUSTOM:kotlin.Int). |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)                     | [getTypeLabelResource](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#getTypeLabelResource(kotlin.Int))`(`type:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Return the string resource that best describes the given[TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#TYPE:kotlin.String).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

|                                                                                                                                                                                                                                                                                                         Properties                                                                                                                                                                                                                                                                                                          ||
|------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| static[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)! | [CONTENT_FILTER_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI:android.net.Uri) The content:// style URL for phone lookup using a filter.                                                                                                                                                                                                                                                                                                               |
| static[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)! | [CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_URI:android.net.Uri) The content:// style URI for all data records of the[CONTENT_ITEM_TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_ITEM_TYPE:kotlin.String)MIME type, combined with the associated raw contact and aggregate contact data.                                                                                        |
| static[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)! | [ENTERPRISE_CONTENT_FILTER_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#ENTERPRISE_CONTENT_FILTER_URI:android.net.Uri) It supports the similar semantics as[CONTENT_FILTER_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI:android.net.Uri)and returns the same columns.                                                                                                                  |
| static[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)  | [ENTERPRISE_CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#ENTERPRISE_CONTENT_URI:android.net.Uri) URI used for getting all data records of the[CONTENT_ITEM_TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_ITEM_TYPE:kotlin.String)MIME type, combined with the associated raw contact and aggregate contact data, from both the calling user and the managed profile that is linked to it. |

## Constants

### CONTENT_ITEM_TYPE

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

```
static val CONTENT_ITEM_TYPE: String
```

MIME type used when storing this in data table.  

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

### CONTENT_TYPE

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

```
static val CONTENT_TYPE: String
```

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

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

### EXTRA_ADDRESS_BOOK_INDEX

```
static val EXTRA_ADDRESS_BOOK_INDEX: String
```

Add this query parameter to a URI to get back row counts grouped by the address book index as cursor extras. For most languages it is the first letter of the sort key. This parameter does not affect the main content of the cursor.

<br />

```kotlin
Example:
 
  import android.provider.ContactsContract.Contacts;
 
  Uri uri = Contacts.CONTENT_URI.buildUpon()
           .appendQueryParameter(Contacts.EXTRA_ADDRESS_BOOK_INDEX, "true")
           .build();
  Cursor cursor = getContentResolver().query(uri,
           new String[] {Contacts.DISPLAY_NAME},
           null, null, null);
  Bundle bundle = cursor.getExtras();
  if (bundle.containsKey(Contacts.EXTRA_ADDRESS_BOOK_INDEX_TITLES) &&
          bundle.containsKey(Contacts.EXTRA_ADDRESS_BOOK_INDEX_COUNTS)) {
      String sections[] =
              bundle.getStringArray(Contacts.EXTRA_ADDRESS_BOOK_INDEX_TITLES);
      int counts[] = bundle.getIntArray(Contacts.EXTRA_ADDRESS_BOOK_INDEX_COUNTS);
  }
  
```

<br />

    Value: "android.provider.extra.ADDRESS_BOOK_INDEX"

### EXTRA_ADDRESS_BOOK_INDEX_COUNTS

```
static val EXTRA_ADDRESS_BOOK_INDEX_COUNTS: String
```

The array of group counts for the corresponding group. Contains the same number of elements as the EXTRA_ADDRESS_BOOK_INDEX_TITLES array.

TYPE: int\[\]  

    Value: "android.provider.extra.ADDRESS_BOOK_INDEX_COUNTS"

### EXTRA_ADDRESS_BOOK_INDEX_TITLES

```
static val EXTRA_ADDRESS_BOOK_INDEX_TITLES: String
```

The array of address book index titles, which are returned in the same order as the data in the cursor.

TYPE: String\[\]  

    Value: "android.provider.extra.ADDRESS_BOOK_INDEX_TITLES"

### NORMALIZED_NUMBER

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

```
static val NORMALIZED_NUMBER: String
```

The phone number's E164 representation. This value can be omitted in which case the provider will try to automatically infer it. (It'll be left null if the provider fails to infer.) If present,[NUMBER](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#NUMBER:kotlin.String)has to be set as well (it will be ignored otherwise).

Type: TEXT  

    Value: "data4"

### NUMBER

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

```
static val NUMBER: String
```

The phone number as the user entered it.

Type: TEXT  

    Value: "data1"

### SEARCH_DISPLAY_NAME_KEY

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

```
static val SEARCH_DISPLAY_NAME_KEY: String
```

A boolean query parameter that can be used with[CONTENT_FILTER_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI:android.net.Uri). If "1" or "true", display names are searched. If "0" or "false", display names are not searched. Default is "1".  

    Value: "search_display_name"

### SEARCH_PHONE_NUMBER_KEY

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

```
static val SEARCH_PHONE_NUMBER_KEY: String
```

A boolean query parameter that can be used with[CONTENT_FILTER_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI:android.net.Uri). If "1" or "true", phone numbers are searched. If "0" or "false", phone numbers are not searched. Default is "1".  

    Value: "search_phone_number"

### TYPE_ASSISTANT

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

```
static val TYPE_ASSISTANT: Int
```  

    Value: 19

### TYPE_CALLBACK

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

```
static val TYPE_CALLBACK: Int
```  

    Value: 8

### TYPE_CAR

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

```
static val TYPE_CAR: Int
```  

    Value: 9

### TYPE_COMPANY_MAIN

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

```
static val TYPE_COMPANY_MAIN: Int
```  

    Value: 10

### TYPE_FAX_HOME

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

```
static val TYPE_FAX_HOME: Int
```  

    Value: 5

### TYPE_FAX_WORK

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

```
static val TYPE_FAX_WORK: Int
```  

    Value: 4

### TYPE_HOME

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

```
static val TYPE_HOME: Int
```  

    Value: 1

### TYPE_ISDN

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

```
static val TYPE_ISDN: Int
```  

    Value: 11

### TYPE_MAIN

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

```
static val TYPE_MAIN: Int
```  

    Value: 12

### TYPE_MMS

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

```
static val TYPE_MMS: Int
```  

    Value: 20

### TYPE_MOBILE

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

```
static val TYPE_MOBILE: Int
```  

    Value: 2

### TYPE_OTHER

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

```
static val TYPE_OTHER: Int
```  

    Value: 7

### TYPE_OTHER_FAX

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

```
static val TYPE_OTHER_FAX: Int
```  

    Value: 13

### TYPE_PAGER

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

```
static val TYPE_PAGER: Int
```  

    Value: 6

### TYPE_RADIO

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

```
static val TYPE_RADIO: Int
```  

    Value: 14

### TYPE_TELEX

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

```
static val TYPE_TELEX: Int
```  

    Value: 15

### TYPE_TTY_TDD

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

```
static val TYPE_TTY_TDD: Int
```  

    Value: 16

### TYPE_WORK

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

```
static val TYPE_WORK: Int
```  

    Value: 3

### TYPE_WORK_MOBILE

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

```
static val TYPE_WORK_MOBILE: Int
```  

    Value: 17

### TYPE_WORK_PAGER

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

```
static val TYPE_WORK_PAGER: Int
```  

    Value: 18

## Public methods

### getTypeLabel

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

```
static fun getTypeLabel(
    res: Resources!, 
    type: Int, 
    label: CharSequence?
): CharSequence!
```

Return a[CharSequence](https://developer.android.com/reference/kotlin/java/lang/CharSequence.html#)that best describes the given type, possibly substituting the given[LABEL](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#LABEL:kotlin.String)value for[TYPE_CUSTOM](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.BaseTypes#TYPE_CUSTOM:kotlin.Int).

|                                                            Parameters                                                            ||
|---------|-------------------------------------------------------------------------------------------------------------------------|
| `label` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?:This value may be`null`. |

### getTypeLabelResource

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

```
static fun getTypeLabelResource(type: Int): Int
```

Return the string resource that best describes the given[TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.CommonColumns#TYPE:kotlin.String). Will always return a valid resource.

## Properties

### CONTENT_FILTER_URI

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

```
static val CONTENT_FILTER_URI: Uri!
```

The content:// style URL for phone lookup using a filter. The filter returns records of MIME type[CONTENT_ITEM_TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_ITEM_TYPE:kotlin.String). The filter is applied to display names as well as phone numbers. The filter argument should be passed as an additional path segment after this URI.

**Caution:** This field doesn't sort results based on contacts frequency. For more information, see the[Contacts Provider](https://developer.android.com/reference/kotlin/guide/topics/providers/contacts-provider#ObsoleteData)page.  

### CONTENT_URI

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

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

The content:// style URI for all data records of the[CONTENT_ITEM_TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_ITEM_TYPE:kotlin.String)MIME type, combined with the associated raw contact and aggregate contact data.  

### ENTERPRISE_CONTENT_FILTER_URI

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

```
static val ENTERPRISE_CONTENT_FILTER_URI: Uri!
```

It supports the similar semantics as[CONTENT_FILTER_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI:android.net.Uri)and returns the same columns. This URI requires[ContactsContract.DIRECTORY_PARAM_KEY](https://developer.android.com/reference/kotlin/android/provider/ContactsContract#DIRECTORY_PARAM_KEY:kotlin.String)in parameters, otherwise it will throw IllegalArgumentException.

**Caution:** If you publish your app to the Google Play Store, this field doesn't sort results based on contacts frequency. For more information, see the[Contacts Provider](https://developer.android.com/reference/kotlin/guide/topics/providers/contacts-provider#ObsoleteData)page.  

### ENTERPRISE_CONTENT_URI

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

```
static val ENTERPRISE_CONTENT_URI: Uri
```

URI used for getting all data records of the[CONTENT_ITEM_TYPE](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_ITEM_TYPE:kotlin.String)MIME type, combined with the associated raw contact and aggregate contact data, from both the calling user and the managed profile that is linked to it.

It supports the same semantics as[CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_URI:android.net.Uri)and returns the same columns.  
If the device has no managed profile that is linked to the calling user, it behaves in the exact same way as[CONTENT_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.CommonDataKinds.Phone#CONTENT_URI:android.net.Uri).  
If there is a managed profile linked to the calling user, it will return merged results from both.

If a result is from the managed profile, the following changes are made to the data:

- [PHOTO_THUMBNAIL_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.ContactsColumns#PHOTO_THUMBNAIL_URI:kotlin.String)and[PHOTO_URI](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.ContactsColumns#PHOTO_URI:kotlin.String)will be rewritten to special URIs. Use android.content.ContentResolver#openAssetFileDescriptor or its siblings to load pictures from them.
- [PHOTO_ID](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.ContactsColumns#PHOTO_ID:kotlin.String)and[PHOTO_FILE_ID](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.ContactsColumns#PHOTO_FILE_ID:kotlin.String)will be set to null. Don't use them.
- [CONTACT_ID](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.RawContactsColumns#CONTACT_ID:kotlin.String)and[LOOKUP_KEY](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.ContactsColumns#LOOKUP_KEY:kotlin.String)will be replaced with artificial values. These values will be consistent across multiple queries, but do not use them in places that don't explicitly say they accept them. If they are used in the`selection`param in android.content.ContentProvider#query, the result is undefined.
- In order to tell whether a contact is from the managed profile, use[ContactsContract.Contacts.isEnterpriseContactId(long)](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.Contacts#isEnterpriseContactId(kotlin.Long)).