Skip to main content
GET
/
api
/
v2
/
sessions
/
{id}
Retrieve a session
curl --request GET \
  --url https://agp.eu.hcompany.ai/api/v2/sessions/{id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://agp.eu.hcompany.ai/api/v2/sessions/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://agp.eu.hcompany.ai/api/v2/sessions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://agp.eu.hcompany.ai/api/v2/sessions/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://agp.eu.hcompany.ai/api/v2/sessions/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://agp.eu.hcompany.ai/api/v2/sessions/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://agp.eu.hcompany.ai/api/v2/sessions/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
Retrieves the complete Session object, including the original request, current status, execution metadata, and latest_answer (the agent’s final answer once produced). This is the cursor-independent way to read a finished run’s result, with no event loop to drain. Auth is optional, so public shares are supported. Returns the Session object if the ID is valid and you have access. Returns 404 otherwise.

​
Path parameters

​
id
string
required
The session ID returned when the session was created.

​
Examples

hai sessions get a1b2c3d4-e5f6-7890-abcd-ef1234567890

curl https://agp.eu.hcompany.ai/api/v2/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer $HAI_API_KEY"

from hai_agents import Client

client = Client()

session = client.sessions.get_session("a1b2c3d4-e5f6-7890-abcd-ef1234567890")
print(session.status.status, session.latest_answer)

import { HaiAgentsClient } from "hai-agents";

const client = new HaiAgentsClient();

const session = await client.sessions.getSession({
  id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
});
console.log(session.status.status, session.latestAnswer);
Response
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "request": {
    "agent": "h/web-surfer-flash",
    "messages": [
      {"type": "user_message", "message": "Find the top 3 stories on Hacker News"}
    ]
  },
  "status": {
    "status": "completed",
    "error": null,
    "steps": 12,
    "usage_per_model": [
      {
        "name": "holo3-1-35b-a3b",
        "input_tokens": 24800,
        "output_tokens": 1420,
        "reasoning_tokens": 0
      }
    ],
    "subagent_session_ids": []
  },
  "agent_view_url": "https://platform.hcompany.ai/agents/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "latest_answer": "1. ... 2. ... 3. ...",
  "created_at": "2026-05-07T14:30:00Z",
  "started_at": "2026-05-07T14:30:02Z",
  "finished_at": "2026-05-07T14:31:15Z"
}

​
Errors

StatusCause
404Session not found, or you don’t have access to it.
If you only need to know whether the session has finished, poll the lighter, faster GET /sessions/{id}/status instead.