> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agenthuman.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Session

> Retrieve a specific session by ID

### Path Parameters

<ParamField path="session_id" type="string" required>
  The ID of the session to retrieve
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Whether the request was successful
</ResponseField>

<ResponseField name="session" type="object">
  The session object (See [Session schema](/api-reference/schemas/session)).
</ResponseField>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "success": true,
    "session": {
      "session_id": "sess_01H3Z8G9YR3K2N5M6P7Q8W4T",
      "status": "ended",
      "started_at": "2024-01-15T12:00:00Z",
      "ended_at": "2024-01-15T12:05:30Z",
      "expiration": "2024-01-15T14:35:00Z",
      "duration": 330,
      "metadata": {
        "user_name": "John Doe",
        "session_purpose": "Customer Support",
        "custom_field": "any value"
      }
    }
  }
  ```
</ResponseExample>

<Note>
  This endpoint does **not** return `session_token` or `room`. Save the `session_token` from the **Create Session** response if you need it for streaming. The `room` configuration is stored but not exposed in API responses.
</Note>