---
title: /oauth2/connect/checkSession
description: Retrieve session state and check end user login status using HTML5 postMessage requests with this OpenID Connect session management endpoint
component: pingam
version: 8.1
page_id: pingam:am-oidc1:rest-api-oidc-checksession-endpoint
canonical_url: https://docs.pingidentity.com/pingam/8.1/am-oidc1/rest-api-oidc-checksession-endpoint.html
llms_txt: https://docs.pingidentity.com/pingam/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-06-01T14:11:17Z
keywords: ["OpenID Connect (OIDC)", "Standards", "Endpoints", "Sessions"]
page_aliases: ["oidc1-guide:rest-api-oidc-checksession-endpoint.adoc"]
---

# /oauth2/connect/checkSession

Use this endpoint to retrieve session state. Learn more in [Session management](session-management.html).

A relying party client creates an invisible iframe with the URL to the endpoint as the `src` attribute of the `iframe` tag. Use the endpoint to accept HTML5 `postMessage` requests from the `iframe`, and to generate `postMessage` requests to the `iframe` with the end user's login status.

*Don't* specify the realm in the request URL. For example:

```none
https://am.example.com:8443/am/oauth2/connect/checkSession
```