Skip to main content
List contact stats
The Hive Inspect API is a work in progress. It is available to a small group of accounts today, and the release for everyone is coming very soon.

Authorizations

Authorization
string
header
required

Your API key from Business Tools → API Access.

Query Parameters

role
string

Count only inspections where the contact had this role (default: any role): agent, client, or an exact role

contact_id
string<uuid>

Stats for one contact

contact_ids
string

Comma-separated contact ids (up to 200)

agency_id
string<uuid>

Only contacts linked to this agency

Name, email, agency name, or phone (3+ digits) contains

tag
string[]

Only contacts with any of these tag names; repeat for several

inspection_after
string

ISO 8601 date or timestamp; count only inspections at/after this time

inspection_before
string

ISO 8601 date or timestamp; count only inspections before this time

first_inspection_after
string

ISO 8601 date or timestamp; contacts whose first inspection is at/after this time

first_inspection_before
string

ISO 8601 date or timestamp; contacts whose first inspection is before this time

inactive_after
string

With inactive_before: contacts with inspections, but none in this range

inactive_before
string

With inactive_after: end of the inactive range

birthday_after
string

MM-DD; birthdays on/after this day of the year

birthday_before
string

MM-DD; birthdays on/before this day of the year

paid_only
boolean

Count only paid inspections

sort
string

total_inspections, buying_agent_inspections, listing_agent_inspections, client_inspections, total_revenue, buying_agent_revenue, listing_agent_revenue, first_inspection_at, last_inspection_at, first_name or last_name; prefix '-' for descending

cursor
string

next_cursor from the previous page

limit
integer

Page size, 1-200 (default 50)

Required range: 1 <= x <= 200

Response

OK

data
object[]
next_cursor
string | null
total
integer

Every record matching the filters, across all pages

Last modified on October 2, 2026