> ## Documentation Index
> Fetch the complete documentation index at: https://elizalabs-force-cache-clear.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Session

> Retrieve session details, status, and remaining time

<Note>
  This endpoint returns comprehensive session information including timeout configuration, renewal count, and real-time expiration status.
</Note>

## Path Parameters

<ParamField path="sessionId" type="string" required>
  The unique identifier of the session
</ParamField>

## Response

<ResponseField name="sessionId" type="string">
  Unique session identifier
</ResponseField>

<ResponseField name="agentId" type="string">
  UUID of the agent
</ResponseField>

<ResponseField name="userId" type="string">
  UUID of the user
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO timestamp of session creation
</ResponseField>

<ResponseField name="lastActivity" type="string">
  ISO timestamp of last activity in the session
</ResponseField>

<ResponseField name="expiresAt" type="string">
  ISO timestamp when the session will expire
</ResponseField>

<ResponseField name="timeoutConfig" type="object">
  Current timeout configuration for the session

  <Expandable title="Configuration Properties">
    <ResponseField name="timeoutMinutes" type="number">
      Inactivity timeout in minutes
    </ResponseField>

    <ResponseField name="autoRenew" type="boolean">
      Whether auto-renewal is enabled
    </ResponseField>

    <ResponseField name="maxDurationMinutes" type="number">
      Maximum total session duration
    </ResponseField>

    <ResponseField name="warningThresholdMinutes" type="number">
      Minutes before expiration to trigger warning
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="renewalCount" type="number">
  Number of times the session has been renewed
</ResponseField>

<ResponseField name="timeRemaining" type="number">
  Milliseconds until session expiration
</ResponseField>

<ResponseField name="isNearExpiration" type="boolean">
  Whether the session is within the warning threshold
</ResponseField>

<ResponseField name="metadata" type="object">
  Any metadata attached to the session
</ResponseField>

## Error Responses

<ResponseExample>
  ```json
  // 404 - Session not found
  {
    "error": "Session not found",
    "code": "SESSION_NOT_FOUND",
    "details": {
      "sessionId": "abc-123"
    }
  }

  // 410 - Session expired
  {
    "error": "Session has expired",
    "code": "SESSION_EXPIRED",
    "details": {
      "sessionId": "abc-123",
      "expiresAt": "2024-01-15T10:30:00Z"
    }
  }
  ```
</ResponseExample>