---
title: "Changes to Search for invoices using specified criteria."
method: POST
path: "/crm/v3/objects/invoices/search"
---

# Changes to Search for invoices using specified criteria.

`POST /crm/v3/objects/invoices/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 470 revisions.

- **2026-09-22** (v3) `ef368316f759`: 1 info
- **2026-09-02** (v3) `410aa1ba6776`: 1 info
- **2026-07-13** (v3) `ce41308fead5`: 1 breaking
- **2026-06-23** (v3) `736ccde6f5fd`: 1 info
- **2026-06-15** (v3) `82f91abdee1f`: 3 breaking, 1 info
- **2026-06-15** (v3) `9c048ea183fd`: 2 breaking, 2 info
- **2026-04-15** (v3) `d3f4dbdcb8fa`: 5 info
- **2026-04-09** (v3) `b92b52896300`: 5 info
- **2026-04-03** (v3) `5c3db0dabaa8`: 1 info
- **2026-02-10** (v3) `1e551dde3efb`: 1 info
- **2025-12-11** (v3) `35b7418a601d`: 2 info
- **2025-12-10** (v3) `3d7ffa174422`: 6 info
- **2025-12-09** (v3) `eb36dca62243`: 6 info
- **2025-11-21** (v3) `e8836c8cf827`: 1 warning
- **2025-11-04** (v3) `a49ba06841fd`: 6 breaking, 1 info

## Changes

- **2026-09-22** (v3) `ef368316f759`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-09-02** (v3) `410aa1ba6776`: 1 info
  - endpoint added
- **2026-07-13** (v3) `ce41308fead5`: 1 breaking
  - api path removed without deprecation
- **2026-06-23** (v3) `736ccde6f5fd`: 1 info
  - added the optional property `results/items/warnings` to the response with the `200` status
- **2026-06-15** (v3) `82f91abdee1f`: 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`
- **2026-06-15** (v3) `9c048ea183fd`: 2 breaking, 2 info
  - removed the enum value `BETWEEN` of the request property `filterGroups/items/filters/items/operator`
  - the `sorts/items/` request property type changed from `string` to `object`
  - added the new `BETWEEN(VALUE` enum value to the request property `filterGroups/items/filters/items/operator`
  - added the new `HIGH_VALUE)` enum value to the request property `filterGroups/items/filters/items/operator`
- **2026-04-15** (v3) `d3f4dbdcb8fa`: 5 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `private_apps` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
- **2026-04-09** (v3) `b92b52896300`: 5 info
  - api operation id `post-/crm/v3/objects/invoices/search` removed and replaced with `post-/crm/v3/objects/invoices/search_doSearch`
  - the endpoint scheme security `app_cookie` was added to the API
  - the endpoint scheme security `hapikey` was added to the API
  - the endpoint scheme security `internal_cookie` was added to the API
  - the endpoint scheme security `shhkey` was added to the API
- **2026-04-03** (v3) `5c3db0dabaa8`: 1 info
  - api operation id `post-/crm/v3/objects/invoices/search_doSearch` removed and replaced with `post-/crm/v3/objects/invoices/search`
- **2026-02-10** (v3) `1e551dde3efb`: 1 info
  - added the optional property `results/items/url` to the response with the `200` status
- **2025-12-11** (v3) `35b7418a601d`: 2 info
  - the endpoint scheme security `oauth2_legacy` was removed from the API
  - the endpoint scheme security `private_apps_legacy` was removed from the API
- **2025-12-10** (v3) `3d7ffa174422`: 6 info
  - the endpoint scheme security `oauth2_legacy` was added to the API
  - the security scope `crm.objects.invoices.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.invoices.read` was added to the endpoint's security scheme `private_apps`
  - the security scope `contacts` was removed from the endpoint's security scheme `private_apps_legacy`
  - the security scope `crm.objects.deals.highly_sensitive.write` was removed from the endpoint's security scheme `private_apps`
  - the security scope `crm.objects.services.read` was removed from the endpoint's security scheme `oauth2`
- **2025-12-09** (v3) `eb36dca62243`: 6 info
  - the endpoint scheme security `oauth2_legacy` was removed from the API
  - the security scope `contacts` was added to the endpoint's security scheme `private_apps_legacy`
  - the security scope `crm.objects.listings.write` was added to the endpoint's security scheme `private_apps`
  - the security scope `crm.objects.orders.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.invoices.read` was removed from the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.invoices.read` was removed from the endpoint's security scheme `private_apps`
- **2025-11-21** (v3) `e8836c8cf827`: 1 warning
  - deleted the `path` request parameter `objectType`
- **2025-11-04** (v3) `a49ba06841fd`: 6 breaking, 1 info
  - added the new path request parameter `objectType`
  - the request property `after` became required
  - the request property `filterGroups` became required
  - the request property `limit` became required
  - the request property `properties` became required
  - the request property `sorts` became required
  - the response property `results/items/archived` became required for the status `200`

---

[Operation](https://skmtc.dev/hubspot/apis/crm-invoices/docs/crm/v3/objects/invoices/search/post.md) - [API](https://skmtc.dev/hubspot/apis/crm-invoices.md) - [Page](https://skmtc.dev/hubspot/apis/crm-invoices/changes/crm/v3/objects/invoices/search/post)