Skip to main content
When using the List organisations using advanced filters endpoint, you can filter on the following fields.

Company Fields

FieldTypeDescriptionSupported Comparisons
company.namestringThe company’s nameequal, not_equal, contains, not_contains, starts_with, doesnt_start_with, set, not_set
company.websitestringThe company’s website/domainequal, not_equal, contains, not_contains, starts_with, doesnt_start_with, set, not_set
company.industrystringThe company’s industry classificationequal, not_equal, in, not_in, set, not_set
company.sizestringThe company’s employee count rangeequal, not_equal, in, not_in, set, not_set
company.countrystringThe company’s country (ISO 3166-1 code)equal, not_equal, in, not_in, set, not_set
company.statestringThe company’s state/regionequal, not_equal, contains, set, not_set
company.citystringThe company’s cityequal, not_equal, contains, set, not_set
company.addressstringThe company’s addressequal, not_equal, contains, set, not_set
company.current_technologies.namestringTechnologies used by the companyequal, not_equal, in, not_in, contains, set, not_set
company.keywordsstringKeywords associated with the companycontains, not_contains

Organisation Fields

FieldTypeDescriptionSupported Comparisons
tagstringTags assigned to the organisationequal, not_equal, in, not_in, contains, not_contains
account_liststringAccount list membershipequal, not_equal, in, not_in

Activity & Visit Fields

FieldTypeDescriptionSupported Comparisons
first_seendateWhen the organisation was first seenequal, greater_than, less_than, between
last_seendateWhen the organisation was last seenequal, greater_than, less_than, between
visited_atdateVisit date (for date range filtering)equal, greater_than, less_than, between
sessionsnumberNumber of sessionsequal, not_equal, greater_than, less_than, between
pageviewsnumberNumber of pageviewsequal, not_equal, greater_than, less_than, between
time_on_sitenumberTime spent on site (in seconds)equal, not_equal, greater_than, less_than, between
urlstringFull URLs visitedequal, not_equal, contains, not_contains, starts_with, doesnt_start_with
pagestringPage paths visitedequal, not_equal, contains, not_contains, starts_with, doesnt_start_with
entry_pagestringEntry page pathequal, not_equal, contains, not_contains, starts_with, doesnt_start_with
exit_pagestringExit page pathequal, not_equal, contains, not_contains, starts_with, doesnt_start_with
first_touchstringFirst touch URLequal, not_equal, contains, not_contains, starts_with, doesnt_start_with
last_touchstringLast touch URLequal, not_equal, contains, not_contains, starts_with, doesnt_start_with
referrerstringReferrer URLequal, not_equal, contains, not_contains, starts_with, doesnt_start_with, set, not_set

UTM Fields

FieldTypeDescriptionSupported Comparisons
utm.sourcestringUTM source parameterequal, not_equal, contains, in, not_in, set, not_set
utm.mediumstringUTM medium parameterequal, not_equal, contains, in, not_in, set, not_set
utm.campaignstringUTM campaign parameterequal, not_equal, contains, in, not_in, set, not_set
utm.termstringUTM term parameterequal, not_equal, contains, in, not_in, set, not_set
utm.contentstringUTM content parameterequal, not_equal, contains, in, not_in, set, not_set

Device Fields

FieldTypeDescriptionSupported Comparisons
device.typestringDevice type (e.g., desktop, mobile, tablet)equal, not_equal, in, not_in
device.browserstringBrowser nameequal, not_equal, in, not_in, contains
device.operating_systemstringOperating systemequal, not_equal, in, not_in, contains

Visitor Location Fields

FieldTypeDescriptionSupported Comparisons
visitor.countrystringVisitor’s country (ISO 3166-1 code)equal, not_equal, in, not_in
visitor.statestringVisitor’s state/regionequal, not_equal, contains, in, not_in
visitor.citystringVisitor’s cityequal, not_equal, contains, in, not_in

CRM Integration Fields

HubSpot Fields

FieldTypeDescriptionSupported Comparisons
hubspot.syncedbooleanWhether synced to HubSpotequal
hubspot.deal_ownerstringHubSpot deal owner nameequal, not_equal, in, not_in, set, not_set
hubspot.deal_stagestringHubSpot deal stageequal, not_equal, in, not_in, set, not_set
hubspot.deal_namestringHubSpot deal nameequal, not_equal, contains, set, not_set
hubspot.company_typestringHubSpot company typeequal, not_equal, in, not_in, set, not_set
hubspot.company_ownerstringHubSpot company owner nameequal, not_equal, in, not_in, set, not_set
hubspot.company_life_cycle_stagestringHubSpot company lifecycle stageequal, not_equal, in, not_in, set, not_set

Other CRM Sync Fields

FieldTypeDescriptionSupported Comparisons
salesforce.syncedbooleanWhether synced to Salesforceequal
dynamics.syncedbooleanWhether synced to Microsoft Dynamicsequal
pipedrive.syncedbooleanWhether synced to Pipedriveequal
zoho.syncedbooleanWhether synced to Zohoequal

Deal Fields

FieldTypeDescriptionSupported Comparisons
deal_stagestringDeal stageequal, not_equal, in, not_in, set, not_set
deal_ownerstringDeal ownerequal, not_equal, in, not_in, set, not_set
deal_namestringDeal nameequal, not_equal, contains, set, not_set

Supported Field Values

Industry Values

For the company.industry field, use one of the industry names from the Company Industries reference table. Example values:
  • Computer Software
  • Financial Services
  • Marketing and Advertising
  • Information Technology and Services
See the full list of supported industry values in the Company Industries reference table.

Size Values

For the company.size field, use one of the following exact values:
Value
Self-employed
1-10 employees
11-50 employees
51-200 employees
201-500 employees
501-1000 employees
1001-5000 employees
5001-10,000 employees
10,001+ employees
See the Company Sizes reference table for more details.

Country Values

For the company.country and visitor.country fields, use ISO 3166-1 alpha-2 country codes. Example values:
  • US (United States)
  • GB (United Kingdom)
  • DE (Germany)
  • NL (Netherlands)
See the Countries reference table for the complete list of supported country codes.

Filter Examples

Filter by Industry

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "company.industry",
        "comparison": "equal",
        "value": "Computer Software"
      }
    ]
  }
}

Filter by Multiple Countries

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "company.country",
        "comparison": "in",
        "value": ["US", "GB", "DE"]
      }
    ]
  }
}

Filter by Company Size Range

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "company.size",
        "comparison": "in",
        "value": ["51-200 employees", "201-500 employees", "501-1000 employees"]
      }
    ]
  }
}

Filter by Company Name

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "company.name",
        "comparison": "contains",
        "value": "Tech"
      }
    ]
  }
}

Complex Filter with Multiple Conditions

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "company.industry",
        "comparison": "in",
        "value": ["Computer Software", "Information Technology and Services"]
      },
      {
        "field": "company.size",
        "comparison": "in",
        "value": ["51-200 employees", "201-500 employees"]
      },
      {
        "field": "company.country",
        "comparison": "equal",
        "value": "US"
      }
    ]
  }
}

Filter by Recent Activity

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "last_seen",
        "comparison": "greater_than",
        "value": 7,
        "unit": "day"
      }
    ]
  }
}

Filter by UTM Campaign

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "utm.source",
        "comparison": "equal",
        "value": "google"
      },
      {
        "field": "utm.campaign",
        "comparison": "contains",
        "value": "summer-sale"
      }
    ]
  }
}

Filter by Page Visits

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "page",
        "comparison": "contains",
        "value": "/pricing"
      }
    ]
  }
}

Nested Filter Groups (OR within AND)

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "company.size",
        "comparison": "in",
        "value": ["201-500 employees", "501-1000 employees"]
      },
      {
        "operator": "OR",
        "conditions": [
          {
            "field": "company.country",
            "comparison": "equal",
            "value": "US"
          },
          {
            "field": "company.country",
            "comparison": "equal",
            "value": "GB"
          }
        ]
      }
    ]
  }
}

Filter by HubSpot Sync Status

{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "hubspot.synced",
        "comparison": "equal",
        "value": false
      },
      {
        "field": "company.size",
        "comparison": "in",
        "value": ["51-200 employees", "201-500 employees"]
      }
    ]
  }
}