---
title: "Search accounts"
method: POST
path: "/search/accounts"
tags: ["Search"]
---

# Search accounts

`POST /search/accounts`

Search for accounts with advanced filtering capabilities. Supports filtering by company attributes like domain, name, industry, employee count, funding, location, and activity levels. Includes pagination, sorting, and full-text search.

## Request body

- AccountSearchRequest
  - `limit` integer — Number of results to return
  - `cursor` integer — Cursor for pagination
  - `search` string — Search query
  - `filters` AccountSearchFilter[] — Filters to apply - restricted to account fields
    - `property` 'name' | 'domain' | 'industry' | 'employees_count' | 'founded_year' | 'raised_amount' | 'country' | 'city' | 'active_users' | 'activities_count', required — Property to filter by - restricted to account fields
    - `operator` 'IS' | 'IS_NOT' | 'GT' | 'GTE' | 'LT' | 'LTE' | 'IN' | 'NOT_IN' | 'BETWEEN' | 'NOT_BETWEEN' | 'IS_NULL' | 'IS_NOT_NULL' | 'CONTAINS' | 'NOT_CONTAINS' | 'STARTS_WITH' | 'ENDS_WITH', required
    - `value` union, required — Filter value
      - string
      - integer
      - number, double
      - boolean
      - string, date-time
      - union[]
        - union
          - string
          - integer
          - number, double
          - boolean
          - string, date-time
  - `filterLogic` 'AND' | 'OR'
  - `sort` CommonModelsSortingParam[] — Sorting parameters
    - `sort_by` string, required — Field to sort by
    - `sort_order` 'asc' | 'desc', required — Sort order

## Response `200`

The request has succeeded.

- AccountSearchResponse
  - `data` AccountDetailSearch[], required — Account search data
    - `mk_id` string, required — Unique identifier for the account in MadKudu
    - `source_system` CommonModelsSourceSystem, required
      - `id` string, required — Unique identifier in the source system
      - `system` string, required — Name of the source system
      - `object` string, required — Object type in the source system
    - `name` string, required — Account name
    - `domain` string, required — Account domain
    - `logo` string — Logo URL
    - `description` string — Account description
    - `industry` string — Industry
    - `founded_year` integer — Founded year
    - `raised_amount` number, double — Raised amount
    - `employees_count` integer — Number of employees
    - `active_users` integer — Number of active users
    - `activities_count` integer — Total activities count
    - `socials` CommonModelsAccountSocials, required
      - `linkedin_handle` string — LinkedIn company handle
      - `twitter_handle` string — Twitter company handle
      - `crunchbase_handle` string — Crunchbase organization handle
      - `website` string — Company website URL
    - `location` CommonModelsLocation, required
      - `country` string — Country
      - `state` string — State or region
      - `city` string — City
    - `scores` CommonModelsScores, required
      - `customer_fit` CommonModelsCustomerFit, required
        - `score` number, double, required — Customer fit score
        - `segment` string, required — Customer fit segment
        - `signals` string — Customer fit signals
      - `likelihood_to_buy` CommonModelsLikelihoodToBuy, required
        - `score` number, double, required — Likelihood to buy score
        - `segment` string, required — Likelihood to buy segment
  - `meta` CommonModelsMeta, required
    - `limit` integer — Number of results returned
    - `total` integer — Total number of results available
    - `has_next_page` boolean — Whether there are more results
    - `next_cursor` integer — Next cursor for pagination

## Other responses

- `422` — Client error

---

[API](https://skmtc.net/madkudu/apis/madapi.md) · [All operations](https://skmtc.net/madkudu/apis/madapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/madkudu/madapi/revisions/80a1ceebb4e7/schema)