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

# Search for projects

`POST /crm/objects/v3/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

- 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-22** (v3) `d9f0d13d4d83` — 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-09-02** (v3) `ce95c3999b4b` — 1 info
  - endpoint added
- **2026-07-13** (v3) `991245afe3f5` — 1 breaking
  - api path removed without deprecation
- **2026-06-23** (v3) `172a134a04e3` — 1 info
  - added the optional property `results/items/warnings` to the response with the `200` status
- **2026-06-15** (v3) `3594db99cfc4` — 3 breaking, 1 info
  - removed the enum value `BETWEEN(VALUE` of the request property `filterGroups/items/filters/items/operator`
  - removed the enum value `HIGH_VALUE)` of the request property `filterGroups/items/filters/items/operator`
  - the `sorts/items/` request property type changed from `object` to `string`
  - added the new `BETWEEN` enum value to the request property `filterGroups/items/filters/items/operator`

[Full history](https://skmtc.dev/hubspot/apis/crm-projects/changes/crm/objects/v3/projects/search/post.md)

---

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