Retrieve a session

curl --request GET \
  --url https://api-us.hihobbes.com/api/v1/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-us.hihobbes.com/api/v1/sessions/{session_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "018f3f6a-0d7b-7f56-bb2a-54c91e57a202",
  "displayId": "SES-1042",
  "startTime": "2026-07-10T18:42:16Z",
  "endTime": "2026-07-10T18:53:04Z",
  "sessionType": "voice",
  "email": "maya@acme.example",
  "name": "Maya Chen",
  "business": "Acme",
  "qualificationStatus": "qualified",
  "buyingIntent": "high",
  "bookedStatus": "booked",
  "sessionStatus": "completed",
  "sentiment": "positive",
  "engagementLevel": "high",
  "primaryIntent": "Evaluate enterprise security",
  "summaryMarkdown": "Maya evaluated Acme's security requirements and booked a technical follow-up.",
  "utmSource": "linkedin",
  "device": "desktop",
  "geoCountry": "US",
  "phone": "+1-415-555-0142",
  "qualificationReason": "Confirmed need, authority, and an active evaluation timeline.",
  "qualificationStage": "technical_evaluation",
  "budgetRange": "$25k-$50k annually",
  "buyingTimeline": "This quarter",
  "decisionMakerRole": "Technical evaluator",
  "isDecisionMaker": false,
  "confidenceScore": 0.91,
  "nextSteps": [
    "Send security documentation",
    "Prepare technical follow-up"
  ],
  "summaryBullets": [
    "Evaluating SSO",
    "Booked technical follow-up"
  ],
  "audioDurationSeconds": 648,
  "timelineEvents": [
    {
      "milestoneType": "feature_discussion",
      "description": "Asked about CRM synchronization.",
      "timestampOffsetS": 184,
      "featuresMentioned": [
        "CRM sync",
        "lead routing"
      ],
      "sequenceOrder": 3
    }
  ],
  "topics": [
    {
      "topic": "Security review",
      "interestLevel": "high",
      "timeDiscussedS": 142,
      "outcome": "Requested technical documentation"
    }
  ],
  "objections": [
    {
      "objectionType": "security",
      "description": "Needs confirmation of SSO support.",
      "severity": "medium",
      "handled": true,
      "resolutionNotes": "Confirmed SAML SSO availability.",
      "timestampOffsetS": 376
    }
  ],
  "tracking": {
    "utmSource": "linkedin",
    "utmMedium": "paid-social",
    "utmCampaign": "enterprise-q3",
    "utmTerm": "ai-demo",
    "utmContent": "security-ad",
    "referrerUrl": "https://www.linkedin.com/",
    "landingPageUrl": "https://acme.example/demo",
    "device": "desktop",
    "browser": "Chrome",
    "os": "macOS",
    "geoCountry": "US",
    "geoRegion": "California",
    "geoCity": "San Francisco"
  },
  "personId": "<string>",
  "qualificationRationale": "<string>",
  "qualificationSource": "automatic",
  "qualificationAssessedAt": "2023-11-07T05:31:56Z",
  "qualificationRubricVersionId": "<string>",
  "overallIntent": "low",
  "intentScore": 0,
  "intentCalculatedAt": "2023-11-07T05:31:56Z",
  "customLinkId": "<string>",
  "customLinkCampaignId": "<string>",
  "lifecycle": {
    "stage": "not_opened",
    "events": [
      {
        "eventType": "opened",
        "observedAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

{
  "detail": "API key required or invalid."
}

{
  "detail": "API key does not include the required scope."
}

{
  "detail": "Session not found, outside the key's organization, or not yet analyzed."
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": "Rate limit or organization quota exceeded."
}

GET

api

sessions

{session_id}

Retrieve a session

curl --request GET \
  --url https://api-us.hihobbes.com/api/v1/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-us.hihobbes.com/api/v1/sessions/{session_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "018f3f6a-0d7b-7f56-bb2a-54c91e57a202",
  "displayId": "SES-1042",
  "startTime": "2026-07-10T18:42:16Z",
  "endTime": "2026-07-10T18:53:04Z",
  "sessionType": "voice",
  "email": "maya@acme.example",
  "name": "Maya Chen",
  "business": "Acme",
  "qualificationStatus": "qualified",
  "buyingIntent": "high",
  "bookedStatus": "booked",
  "sessionStatus": "completed",
  "sentiment": "positive",
  "engagementLevel": "high",
  "primaryIntent": "Evaluate enterprise security",
  "summaryMarkdown": "Maya evaluated Acme's security requirements and booked a technical follow-up.",
  "utmSource": "linkedin",
  "device": "desktop",
  "geoCountry": "US",
  "phone": "+1-415-555-0142",
  "qualificationReason": "Confirmed need, authority, and an active evaluation timeline.",
  "qualificationStage": "technical_evaluation",
  "budgetRange": "$25k-$50k annually",
  "buyingTimeline": "This quarter",
  "decisionMakerRole": "Technical evaluator",
  "isDecisionMaker": false,
  "confidenceScore": 0.91,
  "nextSteps": [
    "Send security documentation",
    "Prepare technical follow-up"
  ],
  "summaryBullets": [
    "Evaluating SSO",
    "Booked technical follow-up"
  ],
  "audioDurationSeconds": 648,
  "timelineEvents": [
    {
      "milestoneType": "feature_discussion",
      "description": "Asked about CRM synchronization.",
      "timestampOffsetS": 184,
      "featuresMentioned": [
        "CRM sync",
        "lead routing"
      ],
      "sequenceOrder": 3
    }
  ],
  "topics": [
    {
      "topic": "Security review",
      "interestLevel": "high",
      "timeDiscussedS": 142,
      "outcome": "Requested technical documentation"
    }
  ],
  "objections": [
    {
      "objectionType": "security",
      "description": "Needs confirmation of SSO support.",
      "severity": "medium",
      "handled": true,
      "resolutionNotes": "Confirmed SAML SSO availability.",
      "timestampOffsetS": 376
    }
  ],
  "tracking": {
    "utmSource": "linkedin",
    "utmMedium": "paid-social",
    "utmCampaign": "enterprise-q3",
    "utmTerm": "ai-demo",
    "utmContent": "security-ad",
    "referrerUrl": "https://www.linkedin.com/",
    "landingPageUrl": "https://acme.example/demo",
    "device": "desktop",
    "browser": "Chrome",
    "os": "macOS",
    "geoCountry": "US",
    "geoRegion": "California",
    "geoCity": "San Francisco"
  },
  "personId": "<string>",
  "qualificationRationale": "<string>",
  "qualificationSource": "automatic",
  "qualificationAssessedAt": "2023-11-07T05:31:56Z",
  "qualificationRubricVersionId": "<string>",
  "overallIntent": "low",
  "intentScore": 0,
  "intentCalculatedAt": "2023-11-07T05:31:56Z",
  "customLinkId": "<string>",
  "customLinkCampaignId": "<string>",
  "lifecycle": {
    "stage": "not_opened",
    "events": [
      {
        "eventType": "opened",
        "observedAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

{
  "detail": "API key required or invalid."
}

{
  "detail": "API key does not include the required scope."
}

{
  "detail": "Session not found, outside the key's organization, or not yet analyzed."
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": "Rate limit or organization quota exceeded."
}

Requires sessions:read. Session detail extends the list representation with qualification reasoning, timeline events, topics, objections, next steps, summary bullets, duration, and complete attribution context. For sessions reached through a Custom Link, lifecycle contains the observed Opened, Started, Engaged, lead, and meeting events. This lifecycle is separate from timelineEvents, which remains the conversation-milestone timeline. Session detail is also the authoritative source for acquisition attribution. Read tracking.utmSource, tracking.utmCampaign, tracking.utmMedium, tracking.utmTerm, and tracking.utmContent. Custom Link and campaign engagement responses do not aggregate UTM values. A 404 means the session is unavailable to the key’s organization or its analysis is not available.

Authorizations

Authorization

string

header

required

Hobbes API key with the hb_live_ prefix.

Path Parameters

session_id

string<uuid>

required

Hobbes session UUID.

Response

Successful Response

string

required

Stable Hobbes session UUID.

Example:

"018f3f6a-0d7b-7f56-bb2a-54c91e57a202"

displayId

string | null

Human-readable session identifier shown in Hobbes.

Example:

"SES-1042"

startTime

string<date-time> | null

Session start time in ISO 8601 format.

Example:

"2026-07-10T18:42:16Z"

endTime

string<date-time> | null

Session end time in ISO 8601 format.

Example:

"2026-07-10T18:53:04Z"

sessionType

string | null

Session channel or experience type.

Example:

"voice"

string | null

Prospect email captured during the session.

Example:

"maya@acme.example"

name

string | null

Prospect name captured during the session.

Example:

"Maya Chen"

business

string | null

Prospect company name.

Example:

"Acme"

qualificationStatus

enum<string>

default:unqualified

Effective person qualification: qualified or unqualified.

Available options:

qualified,

unqualified

Example:

"qualified"

buyingIntent

string | null

Detected buying intent. Common values are high, medium, low, and none.

Example:

"high"

bookedStatus

string | null

Whether the session produced a booking. Common values are booked and not_booked.

Example:

"booked"

sessionStatus

string | null

Latest processing or business status for the session.

Example:

"completed"

sentiment

string | null

Overall prospect sentiment detected in the session.

Example:

"positive"

engagementLevel

string | null

Detected engagement level.

Example:

"high"

primaryIntent

string | null

Primary goal inferred from the conversation.

Example:

"Evaluate enterprise security"

summaryMarkdown

string | null

Markdown summary of the session.

Example:

"Maya evaluated Acme's security requirements and booked a technical follow-up."

utmSource

string | null

Acquisition source captured from UTM parameters.

Example:

"linkedin"

device

string | null

Visitor device category when available.

Example:

"desktop"

geoCountry

string | null

Visitor country when available.

Example:

"US"

phone

string | null

Prospect phone number when captured.

Example:

"+1-415-555-0142"

qualificationReason

string | null

Why Hobbes assigned the qualification status.

Example:

"Confirmed need, authority, and an active evaluation timeline."

qualificationStage

string | null

Detected stage of the buying process.

Example:

"technical_evaluation"

budgetRange

string | null

Budget information expressed by the prospect.

Example:

"$25k-$50k annually"

buyingTimeline

string | null

Expected purchase or evaluation timeline.

Example:

"This quarter"

decisionMakerRole

string | null

Prospect's role in the decision.

Example:

"Technical evaluator"

isDecisionMaker

boolean | null

Whether the prospect appears to be a decision-maker.

Example:

false

confidenceScore

number | null

Model confidence from 0 to 1 for the sales analysis.

Example:

0.91

nextSteps

string[] | null

Recommended or agreed follow-up actions.

Example:

[
  "Send security documentation",
  "Prepare technical follow-up"
]

summaryBullets

string[] | null

Concise session takeaways.

Example:

[
  "Evaluating SSO",
  "Booked technical follow-up"
]

audioDurationSeconds

integer | null

Recorded session duration in seconds.

Example:

648

timelineEvents

TimelineEvent · object[]

Chronological conversation milestones.

Show child attributes

topics

Topic · object[]

Topics detected during the session.

Show child attributes

objections

Objection · object[]

Objections detected during the session.

Show child attributes

tracking

Tracking · object | null

Acquisition, device, and location context.

Show child attributes

personId

string | null

Person UUID associated with the session email.

qualificationRationale

string | null

One- or two-sentence rationale for the effective person qualification.

qualificationSource

enum<string>

default:automatic

automatic or manual.

Available options:

automatic,

manual

qualificationAssessedAt

string<date-time> | null

qualificationRubricVersionId

string | null

overallIntent

enum<string>

default:low

Recency- and frequency-weighted intent across the person's sessions.

Available options:

low,

medium,

high

intentScore

number

default:0

Required range: 0 <= x <= 3

intentCalculatedAt

string<date-time> | null

customLinkId

string | null

Custom Link associated with this session.

customLinkCampaignId

string | null

Custom Link campaign associated with this session.

lifecycle

SessionLifecycle · object | null

Observed Custom Link lifecycle. Separate from conversation timelineEvents.

Show child attributes