---
title: /oauth2/connect/checkSession
description: Use this endpoint to retrieve session state. Learn more in Session management.
component: pingoneaic
page_id: pingoneaic:am-oidc1:rest-api-oidc-checksession-endpoint
canonical_url: https://docs.pingidentity.com/pingoneaic/am-oidc1/rest-api-oidc-checksession-endpoint.html
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://<tenant-env-fqdn>/am/oauth2/connect/checkSession
```