Retrieve a person

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

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

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

{
  "id": "0190a0b3-7f62-7df2-a52e-32b08f86c172",
  "email": "maya@acme.example",
  "name": "Maya Chen",
  "phone": "+1-415-555-0142",
  "business": "Acme",
  "totalSessions": 3,
  "firstSeenAt": "2026-06-18T16:12:00Z",
  "lastSeenAt": "2026-07-10T18:42:16Z",
  "totalTimeSpentSeconds": 1842,
  "firstSource": "google",
  "lastSource": "linkedin",
  "lastLocation": "San Francisco, California, US",
  "qualificationStatus": "qualified",
  "buyingIntent": "high",
  "accountDomain": "acme.example",
  "summaryMarkdown": "Maya is leading Acme's technical evaluation.",
  "qualificationRationale": "<string>",
  "qualificationSource": "automatic",
  "qualificationAssessedAt": "2023-11-07T05:31:56Z",
  "qualificationRubricVersionId": "<string>",
  "overallIntent": "low",
  "intentScore": 0,
  "intentCalculatedAt": "2023-11-07T05:31:56Z"
}

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

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

{
  "detail": "Person 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

people

{email}

Retrieve a person

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

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

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

{
  "id": "0190a0b3-7f62-7df2-a52e-32b08f86c172",
  "email": "maya@acme.example",
  "name": "Maya Chen",
  "phone": "+1-415-555-0142",
  "business": "Acme",
  "totalSessions": 3,
  "firstSeenAt": "2026-06-18T16:12:00Z",
  "lastSeenAt": "2026-07-10T18:42:16Z",
  "totalTimeSpentSeconds": 1842,
  "firstSource": "google",
  "lastSource": "linkedin",
  "lastLocation": "San Francisco, California, US",
  "qualificationStatus": "qualified",
  "buyingIntent": "high",
  "accountDomain": "acme.example",
  "summaryMarkdown": "Maya is leading Acme's technical evaluation.",
  "qualificationRationale": "<string>",
  "qualificationSource": "automatic",
  "qualificationAssessedAt": "2023-11-07T05:31:56Z",
  "qualificationRubricVersionId": "<string>",
  "overallIntent": "low",
  "intentScore": 0,
  "intentCalculatedAt": "2023-11-07T05:31:56Z"
}

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

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

{
  "detail": "Person 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 people:read. Normalize the email to lowercase and URL-encode it before constructing the request path.

const email = encodeURIComponent("maya@acme.example");
const path = `/api/v1/people/${email}`;

Authorizations

Authorization

string

header

required

Hobbes API key with the hb_live_ prefix.

Path Parameters

string

required

Exact prospect email address. URL-encode reserved characters.

Response

Successful Response

string

required

Stable Hobbes person UUID.

Example:

"0190a0b3-7f62-7df2-a52e-32b08f86c172"

string | null

Normalized prospect email.

Example:

"maya@acme.example"

name

string | null

Most recently captured prospect name.

Example:

"Maya Chen"

phone

string | null

Most recently captured phone number.

Example:

"+1-415-555-0142"

business

string | null

Most recently captured company name.

Example:

"Acme"

totalSessions

integer | null

Sessions associated with this person.

Example:

3

firstSeenAt

string<date-time> | null

First known session time.

Example:

"2026-06-18T16:12:00Z"

lastSeenAt

string<date-time> | null

Most recent known session time.

Example:

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

totalTimeSpentSeconds

integer | null

Combined session time in seconds.

Example:

1842

firstSource

string | null

First captured acquisition source.

Example:

"google"

lastSource

string | null

Most recent acquisition source.

Example:

"linkedin"

lastLocation

string | null

Most recent captured location.

Example:

"San Francisco, California, US"

qualificationStatus

enum<string>

default:unqualified

Effective person qualification: qualified or unqualified.

Available options:

qualified,

unqualified

Example:

"qualified"

buyingIntent

enum<string>

default:low

Overall person intent.

Available options:

low,

medium,

high

Example:

"high"

accountDomain

string | null

Registrable business email domain.

Example:

"acme.example"

summaryMarkdown

string | null

Markdown summary across this person's sessions.

Example:

"Maya is leading Acme's technical evaluation."

qualificationRationale

string | null

qualificationSource

enum<string>

default:automatic

Available options:

automatic,

manual

qualificationAssessedAt

string<date-time> | null

qualificationRubricVersionId

string | null

overallIntent

enum<string>

default:low

Available options:

low,

medium,

high

intentScore

number

default:0

Required range: 0 <= x <= 3

intentCalculatedAt

string<date-time> | null

⌘I