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
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