---
title: "Changes to Search Companies"
method: POST
path: "/v2/companies/search"
---

# Changes to Search Companies

`POST /v2/companies/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `187749f77548`: 2 breaking, 22 info

## Changes

- **2026-11-03** `187749f77548`: 2 breaking, 22 info
  - removed the enum value `quarter` of the request property `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #8: DateFilter]/oneOf[subschema #3: DateFilterRelative]/value/unit`
  - removed the enum value `quarter` of the request property `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #8: DateFilter]/oneOf[subschema #4: DateFilterRelativeDate]/value/unit`
  - the endpoint scheme security `apiKeyAuth` was added to the API
  - the endpoint scheme security `oauth2` was added to the API
  - added `company, company-multi, person, person-multi, dropdown, dropdown-multi, ranked-dropdown, date, number, filterable-text, filterable-text-multi, text, location, location-multi` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/` request property
  - added `contains, does-not-contain, starts-with, ends-with, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #12: TextFilter]/` request property
  - added `has-any-of, has-none-of, has-all-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #11: FilterableTextsFilter]/` request property
  - added `has-any-of, has-none-of, has-all-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #14: LocationsFilter]/` request property
  - added `has-any-of, has-none-of, has-all-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #2: CompaniesFilter]/` request property
  - added `has-any-of, has-none-of, has-all-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #4: PersonsFilter]/` request property
  - added `has-any-of, has-none-of, has-all-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #6: DropdownsFilter]/` request property
  - added `is-any-of, is-none-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #10: FilterableTextFilter]/` request property
  - added `is-any-of, is-none-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #13: LocationFilter]/` request property
  - added `is-any-of, is-none-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #1: CompanyFilter]/` request property
  - added `is-any-of, is-none-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #3: PersonFilter]/` request property
  - added `is-any-of, is-none-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #5: DropdownFilter]/` request property
  - added `is-any-of, is-none-of, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #7: RankedDropdownFilter]/` request property
  - added `is-equal-to, is-not-equal-to, is-greater-than, is-greater-than-or-equal-to, is-less-than, is-less-than-or-equal-to, is-between, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #9: NumberFilter]/` request property
  - added `is-on, is-not-on, is-before, is-on-or-before, is-after, is-on-or-after, is-between, is-within-the-last, is-not-within-the-last, is-within-the-next, is-not-within-the-next, is-between-relative, is-exactly-relative, is-not-exactly-relative, is-more-than-relative, is-more-than-or-equal-to-relative, is-less-than-relative, is-less-than-or-equal-to-relative, is-empty, is-not-empty` discriminator mapping keys to the `filters/filters/items/oneOf[subschema #1: ValueFilter]/anyOf[subschema #8: DateFilter]/` request property
  - added `authentication, authorization, bad-request, conflict, method-not-allowed, not-acceptable, not-found, not-implemented, rate-limit, server, timeout, unprocessable-entity, unsupported-media-type, validation` discriminator mapping keys to the `errors/items/` response property for the response status `default`
  - added `bad-request, validation` discriminator mapping keys to the `errors/items/` response property for the response status `400`
  - added `chat-message, email, meeting, call` discriminator mapping keys to the `data/items/fields/items/value/oneOf[subschema #9: InteractionValue]/data/oneOf[subschema #1: Interaction]/` response property for the response status `201`
  - added `company, company-multi, datetime, dropdown, dropdown-multi, number, number-multi, filterable-text, filterable-text-multi, formula-number, interaction, location, location-multi, person, person-multi, ranked-dropdown, text` discriminator mapping keys to the `data/items/fields/items/value` response property for the response status `201`
  - removed the `hidden` enum value from the `data/items/fields/items/type` response property for the response status `201`

---

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