---
title: "Changes to Search all contacts"
method: POST
path: "/contacts/search"
---

# Changes to Search all contacts

`POST /contacts/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `31e7bd6f37e9`: 19 breaking, 6 warning, 56 info

## Changes

- **2026-11-03** `31e7bd6f37e9`: 19 breaking, 6 warning, 56 info
  - request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_CUSTOM_ATTRIBUTE]/operator` was restricted to a list of enum values
  - request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_INSTAGRAM]/operator` was restricted to a list of enum values
  - request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_MAIL]/operator` was restricted to a list of enum values
  - request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_PHONE]/operator` was restricted to a list of enum values
  - the request property `query` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_CUSTOM_ATTRIBUTE]/field` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_CUSTOM_ATTRIBUTE]/identifier` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_CUSTOM_ATTRIBUTE]/operator` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_CUSTOM_ATTRIBUTE]/value` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_INSTAGRAM]/field` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_INSTAGRAM]/operator` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_INSTAGRAM]/value` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_MAIL]/field` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_MAIL]/operator` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_MAIL]/value` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_PHONE]/field` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_PHONE]/operator` became required
  - the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_PHONE]/value` became required
  - removed the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_INSTAGRAM]/column`
  - removed the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_INSTAGRAM]/type`
  - removed the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_MAIL]/column`
  - removed the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_MAIL]/type`
  - removed the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_PHONE]/column`
  - removed the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_PHONE]/type`
  - added `whats_app_username` discriminator mapping keys to the `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/` request property
  - added the new `=` enum value to the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_CUSTOM_ATTRIBUTE]/operator`
  - added the new `=` enum value to the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_INSTAGRAM]/operator`
  - added the new `=` enum value to the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_MAIL]/operator`
  - added the new `=` enum value to the request property `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/oneOf[#/components/schemas/SEARCH_CONTACT_QUERY_PHONE]/operator`
  - added `#/components/schemas/SEARCH_CONTACT_QUERY_WHATS_APP_USERNAME` to the `query/allOf[#/components/schemas/PASearchContactQueryDTO]/value/items/` request property `oneOf` list
  - the response property `errors` became required for the status `401`
  - the response property `errors` became required for the status `403`
  - the response property `errors` became required for the status `404`
  - the response property `errors` became required for the status `500`
  - the response property `errors/items/status_code` became required for the status `401`
  - the response property `errors/items/status_code` became required for the status `403`
  - the response property `errors/items/status_code` became required for the status `404`
  - the response property `errors/items/status_code` became required for the status `500`
  - the response property `pagination` became required for the status `200`
  - …41 more

---

[Operation](https://skmtc.dev/superchat/apis/superchat-api/docs/contacts/search/post.md) - [API](https://skmtc.dev/superchat/apis/superchat-api.md) - [Page](https://skmtc.dev/superchat/apis/superchat-api/changes/contacts/search/post)