POST /v1/trackers/{tracker_code}/companies takes a filters tree of rules combined with and or or, nested as deep as you need. The same rules describe Portal segments (GET /v1/segments) and the rules of ICP Builder and Intent Builder profiles.
Fields
branch_international is the SIC 1987 code every company carries regardless of country, so starts_with ["73"] selects business services everywhere. branch_local codes differ per country (SBI in the Netherlands, NACE in Belgium) and only make sense with a country filter. The reference pages list the accepted values for industries, company sizes, countries and regions, traffic channels and contact fields.
Operators
contains, starts_with, ends_with and their negations accept a list as “any of”: url contains ["/pricing", "/tarieven"] matches either page. between takes exactly two values. Dates are YYYY-MM-DD.
Traffic source fields
medium filters the raw value; the Portal’s Medium categories are direct, referral, email, cpc, organic, social, ai and email_tracker. paid_source (Google Ads, Linkedin Ads, Microsoft Ads, Facebook Ads), organic_source (Google, Bing, DuckDuckGo, Ecosia, Yahoo!), social_source and ai_source (ChatGPT, Claude.ai, Google Gemini, Perplexity.ai, Microsoft Copilot and others) select the source within a channel. campaign matches the UTM or ad campaign name and click_provider the ad platform recognised from click ids.
The relationship shortcut
relationship=prospects applies the usual prospecting exclusions in one parameter: not in a connected CRM, not tagged customer, competitor or not-interesting, not an AI assistant and not shared-network traffic. relationship=existing keeps companies in a CRM or tagged customer. Opportunities default to prospects, the list endpoints to all. To leave out your own relationship tags as well, such as Partner or Login, add exclude_tag_ids or a tag rule with not_in.
Segments
Passsegment_id to apply a segment saved in the Portal. The API translates its rules into this vocabulary and lists anything it could not translate in meta.unsupported_rules, so you always know what was applied.