---
title: "Changes to Search and filter contacts"
method: GET
path: "/contacts/search"
---

# Changes to Search and filter contacts

`GET /contacts/search`

> Every recorded change to this operation, newest first.
> 40 revisions in range; 1 not diffed.

## Timeline

Changed in 10 of 40 revisions.

- **2026-10-22** `549f4adbbfcf`: 4 info
- **2026-10-22** `bdaed6984b20`: 1 warning
- **2026-10-03** `e8a9550eb535`: 1 info
- **2026-09-17** `71b5dd686f80`: 1 warning, 2 info
- **2026-09-01** `9e9922f867ad`: 1 warning
- **2026-08-28** `62bf7284843d`: 1 breaking
- **2026-08-27** `d5f1141f87e3`: 11 warning
- **2026-08-20** `9217eedacbb8`: 1 info
- **2026-08-19** `1ad91026000b`: 1 breaking, 3 info
- **2026-08-05** `3caf12036b26`: 2 breaking

## Changes

- **2026-10-22** `549f4adbbfcf`: 4 info
  - added the new optional `query` request parameter `fitAtLeast`
  - added the optional property `contacts/anyOf[subschema #1]/items/fit` to the response with the `200` status
  - added the optional property `contacts/anyOf[subschema #1]/items/run` to the response with the `200` status
  - added the optional property `contacts/anyOf[subschema #1]/items/whyNow` to the response with the `200` status
- **2026-10-22** `bdaed6984b20`: 1 warning
  - removed the optional property `_meta` from the response with the `200` status
- **2026-10-03** `e8a9550eb535`: 1 info
  - added the optional property `pagination/matched` to the response with the `200` status
- **2026-09-17** `71b5dd686f80`: 1 warning, 2 info
  - deleted the `query` request parameter `minHotScore`
  - added `subschema #1, subschema #2` to the `contacts` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `contacts` response property `anyOf` list for the response status `200`
- **2026-09-01** `9e9922f867ad`: 1 warning
  - removed the optional property `contacts/anyOf[subschema #1]/items/campaigns/items/campaignStatus` from the response with the `200` status
- **2026-08-28** `62bf7284843d`: 1 breaking
  - removed the required property `_meta/credits/accountPlan` from the response with the `200` status
- **2026-08-27** `d5f1141f87e3`: 11 warning
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `400`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `401`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `403`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `404`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `409`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `410`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `422`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `429`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `500`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `502`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `503`
- **2026-08-20** `9217eedacbb8`: 1 info
  - added the new optional `query` request parameter `engaged`
- **2026-08-19** `1ad91026000b`: 1 breaking, 3 info
  - the `contacts` response's property type changed from `array` to no type for status `200`
  - added the new optional `query` request parameter `omitData`
  - added the optional property `_meta` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `contacts` response property `anyOf` list for the response status `200`
- **2026-08-05** `3caf12036b26`: 2 breaking
  - removed the enum value `approved` from the `query` request parameter `lifecycleStage`
  - removed the enum value `converted` from the `query` request parameter `outreachStatus`

---

[Operation](https://skmtc.dev/berea/apis/bereach-api/docs/contacts/search/get.md) · [API](https://skmtc.dev/berea/apis/bereach-api.md) · [Page](https://skmtc.dev/berea/apis/bereach-api/changes/contacts/search/get)