---
title: "Search for companies"
method: POST
path: "/crm/objects/2025-09/companies/search"
tags: ["Search"]
---

# Search for companies

`POST /crm/objects/2025-09/companies/search`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/objects/2025-09/companies/search`
- Auth: none required

Search for companies by filtering on properties, searching through associations, and sorting results. Learn more about [CRM search](https://developers.hubspot.com/docs/guides/api/crm/search#make-a-search-request).

## Request body

- PublicObjectSearchRequest: Describes a search request
  - `after` string, required: A paging cursor token for retrieving subsequent pages.
  - `filterGroups` FilterGroup[], required: Up to 6 groups of filters defining additional query criteria.
    - `filters` Filter[], required: A list of individual filter criteria that are applied together as a group. Each filter specifies a condition that records must meet to be included in the results.
      - `highValue` string: The upper boundary value when using ranged-based filters.
      - `operator` 'BETWEEN' | 'CONTAINS_TOKEN' | 'EQ' | 'GT' | 'GTE' | 'HAS_PROPERTY' | 'IN' | 'LT' | 'LTE' | 'NEQ' | 'NOT_CONTAINS_TOKEN' | 'NOT_HAS_PROPERTY' | 'NOT_IN', required: The comparison operator used in the filter, such as "EQ" or "GT".
      - `propertyName` string, required: The name of the property to apply the filter to.
      - `value` string: The value to match against the property.
      - `values` string[]: The values to match against the property.
  - `limit` integer, required: The maximum results to return, up to 200 objects.
  - `properties` string[], required: A list of property names to include in the response.
  - `query` string: The search query string, up to 3000 characters.
  - `sorts` string[], required: Specifies sorting order based on object properties.

## Response `200`

successful operation

- CollectionResponseWithTotalSimplePublicObject: Represents a list of simple objects returned from an API request, along with the total count of objects available.
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: A paging cursor token for retrieving subsequent pages.
      - `link` string: A URL that can be used to retrieve the next page results.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: A paging cursor token for retrieving previous pages.
      - `link` string: A URL that can be used to retrieve the previous pages' results.
  - `results` SimplePublicObject[], required: An array containing the simple public objects returned in the current page of the response. This property is required.
    - `archived` boolean, required: Whether the object is archived.
    - `archivedAt` string, date-time: The timestamp when the object was archived, in ISO 8601 format.
    - `createdAt` string, date-time, required: The timestamp when the object was created, in ISO 8601 format.
    - `id` string, required: The unique ID of the object.
    - `objectWriteTraceId` string: An identifier used to trace the write request for the object. Set a unique ID for each write operation; it is returned with any errors so you can identify which request encountered which error.
    - `properties` object, required: Key-value pairs representing the properties of the object.
    - `propertiesWithHistory` object: Key-value pairs representing the properties of the object along with their history, each with a timestamp and source information.
    - `updatedAt` string, date-time, required: The timestamp when the object was last updated, in ISO 8601 format.
    - `url` string: The URL associated with the object.
    - `warnings` PublicObjectWarning[]
      - `category` string, required: The classification of the warning, indicating the type or nature of the issue.
      - `context` object, required: Additional information or metadata about the warning, providing context for understanding the issue.
      - `message` string, required: The text of the warning message, providing information about the issue or alert.
  - `total` integer, required: The number of available results

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-25** (2025-09) `2027fd282b1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/crm-companies/changes/crm/objects/2025-09/companies/search/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-companies.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-companies/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-companies/revisions/8d6459ea162b?raw)