GET
/sessions/{session_id}Retrieve a session
Retrieves the details and current status of a session identified by its session ID. Use session_id to look up the session and inspect its user, client, activity timestamps, expiry, and latest activity when available.
session_idstringrequired
The unique identifier of the session to retrieve.
200Returns the session object with its identifier, user and client IDs, status, activity details, timestamps, and any associated tasks.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
idstringrequired
user_idstringrequired
client_idstringrequired
actorobjectoptional
statusstringrequired
last_active_organization_idstringoptional
last_active_atintegerrequired
latest_activityobjectoptional
expire_atintegerrequired
Unix timestamp of expiration.
abandon_atintegerrequired
Unix timestamp of abandonment.
updated_atintegerrequired
Unix timestamp of last update.
created_atintegerrequired
Unix timestamp of creation.
tasksarray<object>optional
400Returned when the request is not successful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
401Returned when authentication is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the session resource is not found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
Error handling
A 400 is returned when the request is not successful, a 401 when authentication is invalid, and a 404 when the session resource is not found. The session_id path parameter must identify a session.