List call sessions

GET/v1/detect/sessions

#Authentication

#Headers

#Query parameters

#Response

200 Success.

• request_idstringrequired
• objectstringrequired

  always "list"

• dataarray of objectrequired
  30 fields in data

  • request_idstring or null
  • typestring

    default "session"always "session"

  • objectstring

    default "noesis.session"always "noesis.session"

  • session_idstringrequired
  • stream_session_idstring or null

    The session id in the socket's ready event (the id the analysis gave the call). session_id is the call's id in your account (the one a stream token returns and the usage event carries). Both work for lookups.

  • operation_idstring or null
  • statusstringrequired

    waiting: the stream token was created but not used yet; active: the call is running; completed / interrupted / failed: the call ended.

    One of: waiting, expired, active, completed, interrupted, failed

  • closedbooleanrequired
  • call_idstring or null

    Your call id, or the provider's (Twilio callSid, Plivo callUuid).

  • transportstring or null

    One of: websocket, file

  • orchestrationstring or null

    binary, json, twilio, plivo or file.

  • encodingstring or null
  • sample_rateinteger or null
  • channelsinteger or null
  • recordbooleanrequired
  • started_atstring or null
  • ready_atstring or null
  • ended_atstring or null
  • end_reasonstring or null
  • audio_secondsnumberrequired

    Seconds of the called person's audio received so far.

  • billed_secondsnumber or null
  • credits_chargedinteger or null
  • latestobject or null

    The latest classification event (live during the call).

  • eventsarray of object

    Classification events, oldest first.

  • errorstring or null
  • labelstring or null

    The answer: the final one after the call, the latest during it.

  • categorystring or null
  • confidencenumber or null
  • decidedboolean or null
  • timelinearray of object or null
• has_morebooleanrequired
• next_cursorstring or nullrequired

#Example response

{
  "request_id": "req_8f14e45fceea167a5a36dedd",
  "object": "list",
  "data": [
    {
      "type": "session",
      "object": "noesis.session",
      "session_id": "5b2f0c9e8d7a4b6c9e1f2a3b4c5d6e7f",
      "stream_session_id": "5b2f0c9e8d7a4b6c9e1f2a3b4c5d6e7f",
      "operation_id": "op_6f1ed002ab5595859014ebf0951522d9",
      "status": "completed",
      "closed": true,
      "call_id": "CA0123456789abcdef0123456789abcdef",
      "transport": "websocket",
      "orchestration": "twilio",
      "encoding": "mulaw",
      "sample_rate": 8000,
      "channels": 1,
      "record": true,
      "started_at": "2026-10-19T09:30:00Z",
      "ready_at": "2026-10-19T09:30:00Z",
      "ended_at": "2026-10-19T09:31:12Z",
      "end_reason": "client_end",
      "audio_seconds": 71.4,
      "billed_seconds": 71.4,
      "latest": {
        "type": "classification",
        "seq": 1,
        "version": 1,
        "t": 4.2,
        "label": "human",
        "category": "human",
        "confidence": 0.93,
        "change": "initial",
        "trigger": "speech",
        "reason": "A person answered and greeted the caller."
      },
      "events": [
        {
          "type": "classification",
          "seq": 1,
          "version": 1,
          "t": 4.2,
          "label": "human",
          "category": "human",
          "confidence": 0.93,
          "change": "initial",
          "trigger": "speech",
          "reason": "A person answered and greeted the caller."
        }
      ],
      "label": "human",
      "category": "human",
      "confidence": 0.93
    }
  ],
  "has_more": false
}

#Errors

Error bodies share one shape with a stable error.code; see Errors for every code and how to fix it.

#Code samples

curl "https://api.noesis.detectif.ai/v1/detect/sessions" \
  -H "Authorization: Bearer $DETECTIF_API_KEY"

import os

import requests

resp = requests.get(
    "https://api.noesis.detectif.ai/v1/detect/sessions",
    headers={"Authorization": f"Bearer {os.environ['DETECTIF_API_KEY']}"},
    timeout=30,
)
print(resp.status_code, resp.json())

const res = await fetch("https://api.noesis.detectif.ai/v1/detect/sessions", {
  headers: {
    Authorization: `Bearer ${process.env.DETECTIF_API_KEY}`,
  },
});
console.log(res.status, await res.json());