> ## 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.

# PresenceRecord (JSON)

> PresenceRecord (JSON)

# PresenceRecord (JSON)

Data about the online presence of a single user.

<a id="ID4EN" />

## PresenceRecord

The PresenceRecord object has the following specification.

| Member   | Type                                                                 | Description                                                                                                                                                                                                                                |
| -------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| xuid     | string                                                               | The XBOX User ID (XUID) of the target user. The presence data provided is for this user.                                                                                                                                                   |
| devices  | array of [DeviceRecord](/reference/live/rest/json/json-devicerecord) | List of the user's device records.                                                                                                                                                                                                         |
| state    | string                                                               | User's activity on XBOX LIVE. Possible values: <ul><li>Online: User has at least one device record.</li><li>Away: User is signed into XBOX LIVE but not active in any title.</li><li>Offline: User is not present on any device.</li></ul> |
| lastSeen | [LastSeenRecord](/reference/live/rest/json/json-lastseenrecord)      | The last seen information is only available when the user has no valid DeviceRecords. If the object was removed from the cache, its data might not be returned, because there is no persistent store.                                      |

<a id="ID4E2C" />

## Sample JSON syntax

```json theme={null}
{
  xuid:"0123456789",
  state:"online",
  devices:
  [{
    type:"D",
    titles:
    [{
      id:"12341234",
      name:"Contoso 5",
      state:"active",
      placement:"fill",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Team Deathmatch on Nirvana"
      }
    },
    {
      id:"12341235",
      name:"Contoso Waypoint",
      timestamp:"2012-09-17T07:15:23.4930000",
      placement:"snapped",
      state:"active",
      activity:
      {
        richPresence:"Using radar"
      }
    }]
  },
  {
    type:"W8",
    titles:
    [{
      id:"23452345",
      name:"Contoso Gamehelp",
      state:"active",
      placement:"full",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Nirvana page"
      }
    }]
  }]
}

```

<a id="ID4EED" />

## See also

<a id="ID4EGD" />

##### Parent

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

<a id="ID4EQD" />

##### Reference

[POST (/users/batch)](/reference/live/rest/uri/presence/uri-usersbatchpost)

[GET (/users/me)](/reference/live/rest/uri/presence/uri-usersmeget)

[DELETE (/users/xuid({xuid})/devices/current/titles/current)](/reference/live/rest/uri/presence/uri-usersxuiddevicescurrenttitlescurrentdelete)

[GET (/users/xuid({xuid}))](/reference/live/rest/uri/presence/uri-usersxuidget)


## Related topics

- [XblSocialManagerPresenceRecordIsUserPlayingTitle](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerpresencerecordisuserplayingtitle.md)
- [Updating a user's Presence via REST](/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)
- [通过 REST 更新用户的 Presence](/zh-CN/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)
- [Actualización de la presencia de un usuario mediante REST](/es/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)
- [REST를 통한 사용자 Presence 업데이트](/ko/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)