Skip to main content
List contacts
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

ids
string

Comma-separated contact ids (up to 200) to fetch in one call

role
string

Only contacts who have had this role on an inspection: agent (Buyer Agent or Listing Agent), client (Customer), or an exact role: Customer, Buyer Agent, Listing Agent, Sub Contractor, Insurance Agent, Lender, Builder, Transaction Coordinator, Attorney, Title Company, Others

tag_id
string

Only contacts with this tag

tag
string[]

Only contacts with any of these tag names (case-insensitive); repeat for several

agency_id
string<uuid>

Only contacts linked to this agency (see /v1/agencies)

email
string

Exact email match (case-insensitive)

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

updated_since
string

ISO 8601 date or timestamp; contacts created or changed at/after this time

sort
string

first_name, last_name, agency_name, created_at or updated_at; prefix '-' for descending (default: by id)

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 4, 2026