---
title: "Search for taxes using specified criteria."
method: POST
path: "/crm/objects/2026-03/taxes/search"
tags: ["Search"]
---

# Search for taxes using specified criteria.

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

Execute a search for tax objects based on defined filters, sorting options, and properties to be included in the response. This allows for customized retrieval of tax data according to specific search parameters.

## 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)