---
title: Get Session Data node
description: Retrieves the value of a specified key from a user's session data, and stores it in the specified key in the shared nodeState object.
component: auth-node-ref
version: 7.4
page_id: auth-node-ref::get-session-data
canonical_url: https://docs.pingidentity.com/auth-node-ref/latest/get-session-data.html
llms_txt: https://docs.pingidentity.com/auth-node-ref/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["Nodes & Trees", "Journeys", "Authentication", "Sessions"]
page_aliases: ["auth-node-get-session-data.adoc"]
superseded_by: https://docs.pingidentity.com/auth-node-ref/latest/get-session-data.html
section_ids:
  compatibility: Compatibility
  outcomes: Outcomes
  properties: Properties
  example: Example
---

# Get Session Data node

Retrieves the value of a specified key from a user's session data, and stores it in the specified key in the shared `nodeState` object.

This node is only used during session upgrade—​when the user has already successfully authenticated previously—​and is now upgrading their session for additional access. Find more information on upgrading a session in [Session upgrade](https://docs.pingidentity.com/pingam/7.4/am-sessions/session-upgrade.html).

This node fails with an error if you attempt to get a property when the user does not have an existing session. Use a [Scripted Decision node](scripted-decision.html) with a script that determines if an existing session is present:

```javascript
if (typeof existingSession !== 'undefined') {
  outcome = "hasSession";
} else {
  outcome = "noSession";
}
```

## Compatibility

| Product                                    | Compatible?           |
| ------------------------------------------ | --------------------- |
| PingOne Advanced Identity Cloud            | [icon: check, set=fa] |
| ForgeRock Access Management (self-managed) | [icon: check, set=fa] |
| Ping Identity Platform (self-managed)      | [icon: check, set=fa] |

## Outcomes

Single outcome path.

## Properties

| Property                      | Usage                                                                                  |
| ----------------------------- | -------------------------------------------------------------------------------------- |
| Session Data Key *(required)* | Specify the name of a key in the user's session data used to retrieve the value.       |
| Shared State Key *(required)* | Specify the name of a key in the `nodeState` object used to store the retrieved value. |

## Example

![Scripted node to check for a session at the start of the flow](_images/trees-node-get-session-data-example-platform.png)

The following table includes example keys that may be available in an existing session and the corresponding sample values:

| Key                          | Sample value                                          |
| ---------------------------- | ----------------------------------------------------- |
| `AMCtxId`                    | `e370cca2-02d6-41f9-a244-2b107206bd2a-122934`         |
| `amlbcookie`                 | `01`                                                  |
| `authInstant`                | `2023-04-04T09:19:05Z`                                |
| `AuthLevel`                  | `0`                                                   |
| `CharSet`                    | `UTF-8`                                               |
| `clientType`                 | `genericHTML`                                         |
| `FullLoginURL`               | `/am/XUI/?realm=alpha#login/`                         |
| `Host`                       | `34.117.172.39`                                       |
| `HostName`                   | `am.forgeblocks.com`                                  |
| `Locale`                     | `en_US`                                               |
| `Organization`               | `dc=openam,dc=forgerock,dc=org`                       |
| `Principal`                  | `uid=amAdmin,ou=People,dc=openam,dc=forgerock,dc=org` |
| `Principals`                 | `amAdmin`                                             |
| `Service`                    | `ldapService`                                         |
| `successURL`                 | `/openam/console`                                     |
| `sun.am.UniversalIdentifier` | `uid=amAdmin,ou=People,dc=openam,dc=forgerock,dc=org` |
| `UserId`                     | `amAdmin`                                             |
| `UserProfile`                | `Required`                                            |
| `UserToken`                  | `amAdmin`                                             |
| `webhooks`                   | `myWebHook`                                           |