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

# Persons

*** ** * ** ***

```
class Persons
```

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

Constants, URI definitions, and query utilities for person identity records aggregated from People Directories.

**For client applications:** Clients query `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_URI:android.net.Uri` using structured query arguments created via `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons.Query.Builder`. Each row in the resulting `https://developer.android.com/reference/kotlin/android/database/Cursor.html#` represents a person record supplied by a specific directory, including standard columns such as `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#LOOKUP_KEY:kotlin.String`, `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#DISPLAY_NAME:kotlin.String`, `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#PHOTO_URI:kotlin.String`, and `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CAPABILITY:kotlin.String`, as well as directory metadata from `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Directory#DIRECTORY_AUTHORITY:kotlin.String` and `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Directory#PACKAGE_NAME:kotlin.String`.

To ensure accurate and fresh data, see `https://developer.android.com/reference/kotlin/android/provider/PeopleContract#EXTRA_NOTIFICATION_URI:kotlin.String`.

**For People Directory applications:** When the system queries a People Directory application for person records, it expects cursors returned by the directory to populate these standard column names, as well as `https://developer.android.com/reference/kotlin/android/provider/PeopleContract#QUERY_ARG_SELECTION_TYPE:kotlin.String` and `https://developer.android.com/reference/kotlin/android/provider/PeopleContract#QUERY_ARG_SELECTION_VALUE:kotlin.String` indicating the exact selection criterion that matched each row.

## Summary

| Nested classes ||
|---|---|
|   | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons.Query` Constants and builder utilities for constructing person query argument bundles. |

| Constants ||
|---|---|
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CAPABILITY:kotlin.String` Column name for a bitmask representing the communication modes supported by this person, composed of flags from `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Capability`. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_ITEM_TYPE:kotlin.String` The MIME type of a `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_URI:android.net.Uri` subdirectory of a single person record. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_TYPE:kotlin.String` The MIME type of `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_URI:android.net.Uri` providing a directory of person records. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#DISPLAY_NAME:kotlin.String` Column name for the primary display name of the person. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#IS_KNOWN:kotlin.String` Indicates whether the person is a known contact or connection in the People Directory application's system. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#LOOKUP_KEY:kotlin.String` Column name for an opaque, stable string key that uniquely identifies this person record within its originating People Directory. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#PHOTO_URI:kotlin.String` Column name for a URI pointing to the person's photo or avatar image. |

| Properties ||
|---|---|
| static [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_LOOKUP_URI:android.net.Uri` The content:// style base URI for persistently referencing a person record by its lookup key. |
| static [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#) | `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_URI:android.net.Uri` The content:// style URI for querying person records aggregated from People Directories. |

## Constants

### CAPABILITY

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

```
static val CAPABILITY: String
```

Column name for a bitmask representing the communication modes supported by this person, composed of flags from `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Capability`.

Type: INTEGER

    Value: "capability"

### CONTENT_ITEM_TYPE

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

```
static val CONTENT_ITEM_TYPE: String
```

The MIME type of a `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_URI:android.net.Uri` subdirectory of a single person record.

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

### CONTENT_TYPE

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

```
static val CONTENT_TYPE: String
```

The MIME type of `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_URI:android.net.Uri` providing a directory of person records.

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

### DISPLAY_NAME

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

```
static val DISPLAY_NAME: String
```

Column name for the primary display name of the person.

Type: TEXT

    Value: "display_name"

### IS_KNOWN

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

```
static val IS_KNOWN: String
```

Indicates whether the person is a known contact or connection in the People Directory application's system.

If a People Directory does not return this, it should be treated as `false` by default.

TYPE: INTEGER (boolean) (Optional)

    Value: "is_known"

### LOOKUP_KEY

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

```
static val LOOKUP_KEY: String
```

Column name for an opaque, stable string key that uniquely identifies this person record within its originating People Directory.

Type: TEXT

    Value: "lookup_key"

### PHOTO_URI

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

```
static val PHOTO_URI: String
```

Column name for a URI pointing to the person's photo or avatar image.

People Directory applications are responsible for hosting photo URIs. Due to performance reasons, using `content://` URIs is not allowed; standard web URLs (such as `https://`) are strongly recommended instead. The Android system does not guarantee access to `content://` URIs.

Type: TEXT

    Value: "photo_uri"

## Properties

### CONTENT_LOOKUP_URI

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

```
static val CONTENT_LOOKUP_URI: Uri
```

The content:// style base URI for persistently referencing a person record by its lookup key.

To construct a stable reference to a person identity in storages like call log entries, append the person's `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#LOOKUP_KEY:kotlin.String` to this URI using `https://developer.android.com/reference/kotlin/android/net/Uri.Builder.html#` or `https://developer.android.com/reference/kotlin/android/net/Uri.html#withAppendedPath(android.net.Uri,%20kotlin.String)`. For example, if a person's lookup key is `"foo"`, then the persistent reference would be `content://com.android.people/persons/lookup/foo`.

**Note:** This URI is intended exclusively for persistent identification and referencing across system components. Direct queries against this URI on the People Provider are unsupported; to resolve a person by lookup key, client applications must query `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons#CONTENT_URI:android.net.Uri` using `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons.Query.Builder#addLookupQuery(kotlin.String,%20kotlin.collections.MutableList)`.

### CONTENT_URI

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

```
static val CONTENT_URI: Uri
```

The content:// style URI for querying person records aggregated from People Directories.

Queries against this URI must be executed via `https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#query(android.net.Uri,%20kotlin.Array,%20android.os.Bundle,%20android.os.CancellationSignal)` using structured query arguments constructed with `https://developer.android.com/reference/kotlin/android/provider/PeopleContract.Persons.Query.Builder`. Traditional SQL selection strings are not supported.