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

# GET (/handles/{handleId}/session)

> GET (/handles/{handleId}/session)

Gets a session object for the specified handle identifier.

> **Important:**\
> This method is used by the 2015 Multiplayer and applies only to that multiplayer version and later. It is intended for use with template contract 104/105 or later, and requires a header element of X-Xbl-Contract-Version: 104/105 or later on every request.

* [Remarks](#ID4ET)
* [URI parameters](#ID4EDB)
* [HTTP status codes](#ID4EOB)
* [Request body](#ID4EVB)
* [Response body](#ID4E6B)

## Remarks

This HTTP/REST method retrieves a session object from the server, using the supplied service-side pointer to the session (handle). The return is the session object, with all its attributes. This method can be wrapped by **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync**.

The caller of this method obtains the handle ID from a player's **MultiplayerActivityDetails** object. Alternatively, the caller gets the ID from a protocol activation after a user has accepted a game invite.

## URI parameters

\| Parameter| Type| Description|
\| --- | --- | --- | --- |
\| handleId| GUID| The unique ID of the handle for the session.|

## HTTP status codes

The service returns an HTTP status code as it applies to MPSD.

## Request body

No objects are sent in the body of this request.

## Response body

See the response structure in [MultiplayerSession (JSON)](https://docs.xbox.com/reference/live/rest/json/json-multiplayersession.md).

## See also

##### Parent

[/handles/{handleId}/session](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession.md)


## Related topics

- [XblMultiplayerGetSessionByHandleAsync](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleasync.md)
- [/handles/{handleId}/session](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession.md)
- [/handles/{handleId}](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleid.md)
- [GET (/handles/{handle-id})](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleidget.md)
- [PUT (/handles/{handle-id}/session)](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionput.md)