Accounts search

The account search API lets you find, filter, and analyze customer or company accounts using flexible Typesense-powered queries. You can search by text, filter by any account property, and select exactly which fields you want in the response.

​

Example use cases

• Get all active accounts in the technology industry

  {
    "query_by": "name,description",
    "filter_by": "is_active:=true&&industry:=technology",
    "q": "*"
  }

• Find accounts with more than 1000 employees

  {
    "query_by": "name",
    "filter_by": "employees:>1000",
    "q": "*"
  }

• List accounts created in the last 90 days

  {
    "query_by": "name",
    "filter_by": "created_at:>2024-03-01",
    "q": "*"
  }

• Get accounts with a specific account owner

  {
    "query_by": "name",
    "filter_by": "account_owner_email:=owner@company.com",
    "q": "*"
  }

• Find accounts with the word ‘acme’ in the name or description

  {
    "query_by": "name,description",
    "q": "acme"
  }

​

Account search response fields

Below are all the fields you may see in an account search result. Many are optional and will only appear if included in your include_fields parameter.

For a full list, see the AccountSearchResponseDto in the API reference.

Tip: Use the include_fields parameter to limit the response to only the fields you need for performance and clarity.