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

# Search for companies

`POST /crm/objects/2026-03/companies/search`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/objects/2026-03/companies/search`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

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

- CrmPublicObjectSearchRequest: Describes a search request
  - `after` string, required: A paging cursor token for retrieving subsequent pages.
  - `filterGroups` CrmFilterGroup[], required: Up to 6 groups of filters defining additional query criteria.
    - `filters` CrmFilter[], required
      - `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

- CrmCollectionResponseWithTotalSimplePublicObject: Represents a list of simple objects returned from an API request, along with the total count of objects available.
  - `paging` Paging
    - `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 string token used to identify the position before the current page in the pagination sequence.
      - `link` string: A URL string that provides a direct link to the previous page of results.
  - `results` CrmSimplePublicObject[], 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 for tracing the write request for the object.
    - `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.
    - `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.
  - `total` integer, required: The number of available results

## Other responses

- `default`: An error occurred.

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-04-08** `b0d8bc008db9`: 1 info
  - api operation id `post-/crm/objects/2026-03/companies/search_doSearch` removed and replaced with `post-/crm/objects/2026-03/companies/search`
- **2026-03-30** `dc2fdad57f7f`: 1 info
  - api operation id `post-/crm/objects/2026-03/companies/search_/crm/objects/2026-03/companies/search` removed and replaced with `post-/crm/objects/2026-03/companies/search_doSearch`
- **2026-03-25** `62586336cea2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/crm/objects/2026-03/companies/search/post.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)