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

# DeviceEndpoint (JSON)

> DeviceEndpoint (JSON)

## DeviceEndpoint

The DeviceEndpoint object has the following specification.

| Member | Type | Description |
| - | - | - |
| deviceName | string | Optional. A friendly name for the device, if applicable. Currently this value is not used. |
| endpointUri | string | Required. The URL that the client platform (Windows or Windows Phone) has obtained from its push notification service (WNS or MPNS). |
| locale | string | Required. The desired language of notifications sent to this endpoint. Can be a list of comma-separated values in preference order. Example: "de-DE, en-US, en". |
| platform | string | Optional. Currently supported values are "WindowsPhone" and "Windows". If not specified, it is derived from the Device token. |
| platformVersion | string | Optional. The format of this string is particular to each platform. Currently this value is not used. |
| systemId | GUID | Required. Unique identifier for the "app instance" (device/user combination). Best practice implementation is for an app to generate a random GUID upon install/first-run, and continue to use that value on subsequent runs of the app. |
| titleId | 32-bit unsigned integer | Required. The Title ID of the game issuing the call to the service. |

## Sample JSON syntax

```json theme={null}
{
  "systemId": "e9af05b4-70de-4920-880f-026c6fb67d1b",
  "userId" : 1234567890
  "endpointUri": "http://cloud.notify.windows.com/.../",
  "platform": "Windows",
  "platformVersion": "1.0",
  "deviceName": "Test Endpoint",
  "locale": "en-US",
  "titleId": 1297290219
}
    
```

## See also

##### Parent

[JavaScript Object Notation (JSON) Object Reference](https://docs.xbox.com/reference/live/rest/json/atoc-xboxlivews-reference-json.md)

##### Reference


## Related topics

- [JavaScript Object Notation (JSON) Object Reference](https://docs.xbox.com/reference/live/rest/json/atoc-xboxlivews-reference-json.md)
- [Party Quickstart](https://docs.xbox.com/services/playfab/multiplayer/networking/quickstart.md)
- [XblAchievementUnlockEvent](https://docs.xbox.com/reference/live/xsapi-c/achievements_c/structs/xblachievementunlockevent.md)
- [Report Device Info](https://docs.xbox.com/services/playfab/api-references/rest/client/analytics/report-device-info.md)
- [XBOX PC Remote (wdRemote.exe)](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdRemote.md)