View session information

Boundary creates a session when you connect to a target. Sessions reside in the project scope that contains the target you accessed.

You can view information for any session that is active, pending, or currently being canceled.

Complete the following steps to view session information:

Log in to Boundary.
In the navigation menu, select Orgs.
Select the org that contains the project for which you want to view sessions.
Select the project.
In the navigation menu, select Sessions.
The Sessions page displays the following information about any sessions in that project:
- Session ID
- User who initiated the session
- Target name
- Start date
- Session status

You can use the list or read commands to view session information. The list command lists all sessions for a scope, while the read command displays detailed information for a specific session.

View all sessions in a specific scope

Complete the following steps to view all sessions in a specific scope:

Use the following command and provide the project scope's ID:

$ boundary sessions list -scope-id <SCOPE_ID>

Boundary displays the following information for any sessions in the project scope:

$ boundary sessions list -scope-id p_1234567890

Session information:
    ID:               s_h7vBIhH5SZ
    Status:           active
    Created Time:     2026-03-30T15:18:14-07:00
    Expiration Time:  2026-03-30T23:18:14-07:00
    Updated Time:     2026-03-30T15:18:35-07:00
    User ID:          u_1234567890
    Target ID:        ttcp_1234567890

View detailed information about a specific session

Complete the following steps to view detailed information about a specific session:

Use the following command and provide the session ID:

$ boundary sessions read -id <SESSION_ID>

Boundary displays the following information for the session:

$ boundary sessions read -id s_h7vBIhH5SZ

Session information:
    Auth Token ID:       at_51XQGx0bzk
    Created Time:        2026-03-30T15:18:14-07:00
    Endpoint:            tcp://localhost:22
    Expiration Time:     2026-03-30T23:18:14-07:00
    Host ID:             hst_1234567890
    Host Set ID:         hsst_1234567890
    ID:                  s_h7vBIhH5SZ
    Status:              active
    Target ID:           ttcp_1234567890
    Type:                tcp
    Updated Time:        2026-03-30T15:18:35-07:00
    User ID:             u_1234567890
    Version:             2

    Scope:
        ID:                p_1234567890
        Name:              Generated project scope
        Parent Scope ID:   o_1234567890
        Type:              project

    States:
        Start Time:        Mon, 30 Mar 2026 15:18:35 MST
        Status:            active

        End Time:          Mon, 30 Mar 2026 15:18:35 MST
        Start Time:        Mon, 30 Mar 2026 15:18:14 MST
        Status:            pending

More information

To better understand sessions, refer to Overview of sessions.
For more specific information about how the session resource relates to other Boundary resources, refer to the Sessions domain model topic.
To view the possible session parameters, refer to the session CLI or API documentation.

Next steps

Cancel a session if you no longer need it or detect unexpected activity.
Pre-authorize a session by creating an authorization token in advance.