Skip to main content
GET
List people
Requires people:read. People are ordered by lastSeenAt, newest first. Use intent, qualification, date, and partial-email filters to build prospect cohorts. Person profiles evolve as later sessions update activity, intent, qualification, and summary fields.

Authorizations

Authorization
string
header
required

Hobbes API key with the hb_live_ prefix.

Query Parameters

search
string | null

Partial email match

buying_intent
string | null

high | medium | low | none (comma-separated)

qualification_status
string | null

qualified | unqualified (comma-separated)

date_from
string<date-time> | null

Filter by last seen (ISO 8601)

date_to
string<date-time> | null

Filter by last seen (ISO 8601)

limit
integer
default:50

Number of records to return. Defaults to 50 and cannot exceed 200.

Required range: 1 <= x <= 200
offset
integer
default:0

Zero-based number of records to skip. Use with pagination.total to request the next page.

Required range: 0 <= x <= 1000000

Response

Successful Response

people
PersonItem · object[]
required
pagination
Pagination · object
required