Skip to main content
GET
Accounts reached out to

Authorizations

api-key
string
header
required

Scopes

mcp.read

Query Parameters

start_date
string
required

Start of the period, YYYY-MM-DD (UTC, inclusive). Required.

Pattern: ^\d{4}-\d{2}-\d{2}$
end_date
string
required

End of the period, YYYY-MM-DD (UTC, inclusive). Required.

Pattern: ^\d{4}-\d{2}-\d{2}$

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

fields
string

Comma-separated metrics to return; omit for all.

Maximum string length: 4000

Response

OK

data
object
required

How many accounts your team reached out to and heard back from in the period. An account counts when its latest outreach (or reply) falls in the period.

meta
object
required