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

# Search for projects

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

Search for projects 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.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/versions/f9c7181056c5/schema)