Skip to main content
GET
List contacts

Authorizations

​
api-key
string
header
required

Scopes

​
mcp.read

Query Parameters

​
search
string

Free-text match on company and contact names.

Maximum string length: 200
​
account_competitors
string[]

Accounts with signals for any of these competitors (names from GET /fields?object=account).

Required array length: 1 - 200 elements
Required string length: 1 - 500
​
account_competitor_cycle_stage
enum<string>[]

Inferred competitor buying-cycle stage.

Required array length: 1 - 200 elements
Available options:
Aware of Competitor,
Historical,
Prospecting,
Early Stage,
Late Stage
​
account_priority
enum<string>[]

Priority.

Required array length: 1 - 200 elements
Available options:
High,
Medium,
Nurture
​
account_icp_fit
enum<string>

true = only ICP-fit accounts, false = only the rest.

Available options:
true,
false
​
account_signal_freshness
enum<string>[]

Stale alone = only stale accounts; Recent and Historic together = exclude stale accounts. Other combinations are rejected: Recent and Historic cannot be filtered apart yet.

Required array length: 1 - 200 elements
Available options:
Recent,
Historic,
Stale
​
latest_signal_within_days
integer

Accounts whose latest signal was within the last N days.

Required range: 1 <= x <= 3650
​
latest_signal_after
string

Latest signal on or after this date.

​
latest_signal_before
string

Latest signal on or before this date.

​
company_size
string[]

Employee bands, e.g. "51-200".

Required array length: 1 - 200 elements
Required string length: 1 - 500
​
company_hq_country
string[]

Headquarters country, ISO 3166-1 alpha-2 (e.g. "US"); a country name ("United States") is accepted too.

Required array length: 1 - 200 elements
Required string length: 2 - 100
​
crm_has_account
enum<string>

true = the account was already in your CRM when we found it, false = net new (it was not). An account added to the CRM later can have crm_account_url set and still be net new.

Available options:
true,
false
​
crm_is_customer
enum<string>

true = your customers only, false = exclude them.

Available options:
true,
false
​
crm_has_opp
enum<string>

false = accounts with no CRM opportunity. true is the same as listing every crm_latest_opp_stage.

Available options:
true,
false
​
crm_latest_opp_stage
string[]

Latest opportunity's stage, as your CRM labels it (values from GET /fields?object=account).

Required array length: 1 - 200 elements
Required string length: 1 - 500
​
crm_latest_opp_owner_email
string<email>[]

Latest opportunity owner's email.

Required array length: 1 - 200 elements
Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
​
crm_account_owner_name
string[]

CRM account owner's name (values from GET /fields?object=account).

Required array length: 1 - 200 elements
Required string length: 1 - 500
​
crm_account_owner_email
string<email>[]

CRM account owner's email.

Required array length: 1 - 200 elements
Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
​
crm_latest_opp_date_within_days
integer

Latest opportunity created or closed within the last N days.

Required range: 1 <= x <= 3650
​
crm_latest_opp_date_older_than_days
integer

Latest opportunity created or closed more than N days ago.

Required range: 1 <= x <= 3650
​
crm_latest_opp_date_after
string

Latest opportunity created or closed on or after this date.

​
crm_latest_opp_date_before
string

Latest opportunity created or closed on or before this date.

​
outreach_status
enum<string>[]

Where outreach stands. *_after_signal values count only outreach after the first signal.

Required array length: 1 - 200 elements
Available options:
reached_out,
replied,
opportunity_created,
not_reached_out,
reached_out_after_signal,
replied_after_signal,
opportunity_created_after_signal
​
outreach_attribution
enum<string>[]

Attribution verdict.

Required array length: 1 - 200 elements
Available options:
direct_reply,
driven,
assisted,
detected,
competitive_deal,
not_attributed
​
preset
enum<string>

A prebuilt view of the table. CRM presets replace crm_latest_opp_stage with their own rule.

Available options:
pilot,
advertising,
capacity_based_outbound,
sell_now,
competitor_aware_tam,
customers_at_risk,
competitive_deals
​
crm_custom_fields
object

Custom CRM fields, as crm_custom_fields[::]= (e.g. crm_custom_fields[hubspot:company:Tier]=A). Fields AND together; values of one field OR.

​
sort
enum<string>

Sort field. Default latest_signal_date.

Available options:
latest_signal_date,
account_priority,
crm_latest_opp_created_date,
crm_latest_opp_close_date
​
order
enum<string>

Sort order. Default desc.

Available options:
asc,
desc
​
include
string

contact_info adds contact_work_email and contact_phone_number.

​
fields
string

Comma-separated Contact row fields to return; omit for all. Reach into a list with a dot (contacts.contact_name, contacts.signals.signal_date). account_id and signal_id always ship.

Maximum string length: 4000
​
filter
object

Filter on any Contact row key GET /fields lists: filter[]= (repeat for any of several values) or filter[][]= with eq, ne, contains, gt, gte, lt, lte, exists. Keys inside a list (contacts.contact_job_title, signals.signal_freshness) match when any element matches. Combines with the dedicated filters; all of them must hold.

​
page_size
integer

Rows per page, 1-500. Default 25.

Required range: 1 <= x <= 500
​
offset
integer

Rows to skip, to jump to a position. Cannot be combined with cursor.

Required range: 0 <= x <= 100000
​
cursor
string

pagination.next_cursor from the previous page. Send only cursor (plus page_size or fields): the query travels inside it.

Required string length: 1 - 8192

Response

OK

​
data
object
required
​
meta
object
required
​
pagination
object