> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PeopleList (JSON)

> PeopleList (JSON)

# PeopleList (JSON)

Collection of [Person](/reference/live/rest/json/json-person) objects.

<a id="ID4ER" />

## PeopleList

The PeopleList object has the following specification.

| Member     | Type                                                     | Description                                                                                                                                                                                                                                        |
| ---------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| people     | array of [Person](/reference/live/rest/json/json-person) | The [Person](/reference/live/rest/json/json-person) objects that make up the people list.                                                                                                                                                          |
| totalCount | 32-bit unsigned integer                                  | Total number of [Person](/reference/live/rest/json/json-person) objects available in the set. This value can be used by clients for paging because it represents the size of the whole set, not just the most recent response. Example value: 680. |

<a id="ID4EAC" />

## Sample JSON syntax

```json theme={null}
{
    "people": [
        {
            "xuid": "2603643534573573",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573572",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573577",
            "isFavorite": false,
            "isFollowingCaller": false
        },
    ],
    "totalCount": 3
}
    
```

<a id="ID4EJC" />

## See also

<a id="ID4ELC" />

##### Parent

[JavaScript Object Notation (JSON) Object Reference](/reference/live/rest/json/atoc-xboxlivews-reference-json)

<a id="ID4EVC" />

##### Reference

[GET (/users/](/reference/live/rest/uri/people/uri-usersowneridpeople){ownerId}[/people)](/reference/live/rest/uri/people/uri-usersowneridpeople)

[POST (/users/](/reference/live/rest/uri/people/uri-usersowneridpeoplexuidspost){ownerId}[/people/xuids)](/reference/live/rest/uri/people/uri-usersowneridpeoplexuidspost)


## Related topics

- [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [People system](/services/xbox-services/community/people-system/index.md)
- [People System (Friends List)](/services/xbox-services/community/people-system/live-people-system-nav.md)
- [People 系统](/zh-CN/services/xbox-services/community/people-system/index.md)
- [People System](/ko/services/xbox-services/community/people-system/index.md)