Retrieve an account

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

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

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

{
  "id": "0190a0d8-27f1-77f2-a1aa-f84230d50720",
  "accountDomain": "acme.example",
  "companyName": "Acme",
  "totalUsers": 4,
  "totalSessions": 7,
  "bookedSessions": 2,
  "highIntentUsers": 2,
  "qualifiedUsers": 3,
  "totalTimeSpentSeconds": 4210,
  "lastSeenAt": "2026-07-10T18:42:16Z",
  "summaryMarkdown": "Acme has an active multi-stakeholder technical evaluation."
}

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

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

{
  "detail": "Account not found in the key's organization."
}

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

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

GET

api

accounts

{domain}

Retrieve an account

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

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

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

{
  "id": "0190a0d8-27f1-77f2-a1aa-f84230d50720",
  "accountDomain": "acme.example",
  "companyName": "Acme",
  "totalUsers": 4,
  "totalSessions": 7,
  "bookedSessions": 2,
  "highIntentUsers": 2,
  "qualifiedUsers": 3,
  "totalTimeSpentSeconds": 4210,
  "lastSeenAt": "2026-07-10T18:42:16Z",
  "summaryMarkdown": "Acme has an active multi-stakeholder technical evaluation."
}

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

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

{
  "detail": "Account not found in the key's organization."
}

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

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

Requires accounts:read. Pass the registrable business domain, such as acme.example, not a full URL or email address. URL-encode the value before constructing the request path.

Authorizations

Authorization

string

header

required

Hobbes API key with the hb_live_ prefix.

Path Parameters

domain

string

required

Registrable account domain, such as acme.example.

Response

Successful Response

string

required

Stable Hobbes account UUID.

Example:

"0190a0d8-27f1-77f2-a1aa-f84230d50720"

accountDomain

string | null

Registrable business email domain.

Example:

"acme.example"

companyName

string | null

Resolved company name.

Example:

"Acme"

totalUsers

integer | null

Known people associated with this account.

Example:

4

totalSessions

integer | null

Sessions associated with this account.

Example:

7

bookedSessions

integer | null

Sessions that produced a booking.

Example:

2

highIntentUsers

integer | null

People with high detected buying intent.

Example:

2

qualifiedUsers

integer | null

People whose latest qualification status is qualified.

Example:

3

totalTimeSpentSeconds

integer | null

Combined session time in seconds.

Example:

4210

lastSeenAt

string<date-time> | null

Most recent associated session time.

Example:

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

summaryMarkdown

string | null

Markdown account summary across people and sessions.

Example:

"Acme has an active multi-stakeholder technical evaluation."

⌘I