Skip to main content
POST
Search contacts

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string

Search text. Matches names, titles, vendors, buyers, and products. Supports quoted phrases and boolean operators such as AND, OR, and NOT.

cursor
string

Opaque pagination token from the previous response's meta.nextCursor. Omit for the first page. Tokens are bound to the query, filters, and sort inputs and carry no format guarantee.

perPage
integer
default:25
Required range: x <= 100
sort
enum<string>

Sort field. Defaults to last_active (most recently active first).

Available options:
last_active,
opp_count
sortDirection
enum<string>
Available options:
asc,
desc
jurisdictionLevel
enum<string>

Filter by government level - federal (country-level) or regional (state/local). Defaults to federal when omitted.

Available options:
federal,
regional
placeIds
string[]

Canonical Govly Place ids to filter by. A contact's places are the union of every opportunity they are attached to, so this means "has ever worked in". jurisdictionLevel defaults to federal, so set it explicitly when filtering by a state or local place.

placeIdsNone
string[]

Canonical Govly Place ids to exclude. Because a contact's places come from all their opportunities, this excludes anyone whose opportunities ever touched the place, not merely those based there.

buyerIds
string[]

Filter to contacts associated with any of these Govly buyer (government entity) ids.

buyerDomains
string[]

Filter to contacts associated with any of these buyer email domains, such as gsa.gov.

vendorNames
string[]

Filter to contacts associated with any of these vendor names.

titles
string[]

Filter to contacts holding any of these job titles, such as Contracting Officer.

Response

Matching contacts

data
object[]
required
meta
object
required