Skip to main content
GET
Confirmed evaluations

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

Accounts your team confirmed are evaluating vendors.

meta
object
required