--- title: Read One Session description: The GET {{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}} operation returns a single session for the specified user and environment. component: pingone-api page_id: pingone-api:platform:users/user-sessions/read-a-session canonical_url: https://developer.pingidentity.com/pingone-api/platform/users/user-sessions/read-a-session.html section_ids: role-information: Role information headers: Headers example-request: Example Request example-response: Example Response --- # Read One Session ## ```none GET {{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}} ``` The `GET {{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}` operation returns a single session for the specified user and environment. The session information returned includes session location, date, browser, operating system, and device information. ### Role information A user having the Identity Data Administrator role assigned at the Population level can read sessions for any users in the assigned populations. They cannot read sessions for users outside of those populations, even if the users are in the same environment. A user having the Identity Data Administrator role assigned at the Environment level can read the sessions of any user in any population in that environment. ### Headers Authorization      Bearer {{accessToken}} ## ### Example Request * cURL * C# * Go * HTTP * Java * jQuery * NodeJS * Python * PHP * Ruby * Swift ```shell curl --location --globoff '{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}' \ --header 'Authorization: Bearer {{accessToken}}' ``` ```csharp var options = new RestClientOptions("{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("", Method.Get); request.AddHeader("Authorization", "Bearer {{accessToken}}"); RestResponse response = await client.ExecuteAsync(request); Console.WriteLine(response.Content); ``` ```golang package main import ( "fmt" "net/http" "io" ) func main() { url := "{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}" method := "GET" client := &http.Client { } req, err := http.NewRequest(method, url, nil) if err != nil { fmt.Println(err) return } req.Header.Add("Authorization", "Bearer {{accessToken}}") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := io.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) } ``` ```http GET /v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}} HTTP/1.1 Host: {{apiPath}} Authorization: Bearer {{accessToken}} ``` ```java OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("text/plain"); RequestBody body = RequestBody.create(mediaType, ""); Request request = new Request.Builder() .url("{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}") .method("GET", body) .addHeader("Authorization", "Bearer {{accessToken}}") .build(); Response response = client.newCall(request).execute(); ``` ```javascript var settings = { "url": "{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}", "method": "GET", "timeout": 0, "headers": { "Authorization": "Bearer {{accessToken}}" }, }; $.ajax(settings).done(function (response) { console.log(response); }); ``` ```javascript var request = require('request'); var options = { 'method': 'GET', 'url': '{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}', 'headers': { 'Authorization': 'Bearer {{accessToken}}' } }; request(options, function (error, response) { if (error) throw new Error(error); console.log(response.body); }); ``` ```python import requests url = "{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}" payload = {} headers = { 'Authorization': 'Bearer {{accessToken}}' } response = requests.request("GET", url, headers=headers, data=payload) print(response.text) ``` ```php setUrl('{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}'); $request->setMethod(HTTP_Request2::METHOD_GET); $request->setConfig(array( 'follow_redirects' => TRUE )); $request->setHeader(array( 'Authorization' => 'Bearer {{accessToken}}' )); try { $response = $request->send(); if ($response->getStatus() == 200) { echo $response->getBody(); } else { echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' . $response->getReasonPhrase(); } } catch(HTTP_Request2_Exception $e) { echo 'Error: ' . $e->getMessage(); } ``` ```ruby require "uri" require "net/http" url = URI("{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}") http = Net::HTTP.new(url.host, url.port); request = Net::HTTP::Get.new(url) request["Authorization"] = "Bearer {{accessToken}}" response = http.request(request) puts response.read_body ``` ```swift var request = URLRequest(url: URL(string: "{{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/sessions/{{sessionID}}")!,timeoutInterval: Double.infinity) request.addValue("Bearer {{accessToken}}", forHTTPHeaderField: "Authorization") request.httpMethod = "GET" let task = URLSession.shared.dataTask(with: request) { data, response, error in guard let data = data else { print(String(describing: error)) return } print(String(data: data, encoding: .utf8)!) } task.resume() ``` ### Example Response 200 OK ```json { "_links": { "self": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/710d6278-ccce-4a91-bdb9-ac7a4a0e60d5/sessions" }, "environment": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6" }, "user": { "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/710d6278-ccce-4a91-bdb9-ac7a4a0e60d5" } }, "id": "465b7031-292f-4641-941f-e21240a88a43", "environment": { "id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6" }, "user": { "id": "710d6278-ccce-4a91-bdb9-ac7a4a0e60d5" }, "createdAt": "2022-09-20T16:00:57.382Z", "activeAt": "2022-10-11T16:59:42.302Z", "idleTimeoutInMinutes": 43200, "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36", "browser": { "name": "Chrome", "version": "106.0.0" }, "operatingSystem": { "name": "Mac OS X", "version": "10.15.7" }, "device": { "type": "Mac" }, "locations": [ { "at": "2022-10-06T16:27:55.647Z", "remoteIp": "65.152.119.108", "city": "henderson", "state": "colorado", "region": "mountain", "country": "united states" }, { "at": "2022-10-06T18:54:55.623Z", "remoteIp": "65.152.119.108", "city": "henderson", "state": "colorado", "region": "mountain", "country": "united states" }, { "at": "2022-10-11T16:44:00.402Z", "remoteIp": "65.152.119.108", "city": "henderson", "state": "colorado", "region": "mountain", "country": "united states" }, { "at": "2022-10-11T16:52:37.473Z", "remoteIp": "65.152.119.108", "city": "henderson", "state": "colorado", "region": "mountain", "country": "united states" }, { "at": "2022-10-11T16:59:42.302Z", "remoteIp": "65.152.119.108", "city": "henderson", "state": "colorado", "region": "mountain", "country": "united states" } ], "lastSignOn": { "remoteIp": "65.152.119.108", "authenticators": [ "pwd" ], "withAuthenticator": { "pwd": { "policy": { "id": "6b7fbe27-15e7-4b89-a176-5c35ae30855f", "type": "PINGONE" }, "at": "2022-10-11T16:44:00.401Z" } }, "policy": { "id": "6b7fbe27-15e7-4b89-a176-5c35ae30855f", "type": "PINGONE" }, "at": "2022-10-11T16:44:00.401Z" }, "expiresAt": "2022-11-10T16:59:42.302Z" } ```