--- title: "Changes to Find people from public data" method: POST path: "/public/search" --- # Changes to Find people from public data `POST /public/search` > Every recorded change to this operation, newest first. > 40 revisions in range; 1 not diffed. ## Timeline Changed in 11 of 40 revisions. - **2026-10-22** `549f4adbbfcf`: 33 breaking, 11 info - **2026-10-22** `0d86cfdab3a4`: 2 info - **2026-10-21** `d04cdb8563c3`: 4 info - **2026-10-03** `e8a9550eb535`: 10 warning, 28 info - **2026-09-18** `4461a51fb989`: 5 breaking, 8 warning, 4 info - **2026-09-01** `9e9922f867ad`: 1 info - **2026-08-28** `62bf7284843d`: 2 breaking, 20 info - **2026-08-27** `d5f1141f87e3`: 1 breaking, 11 warning, 22 info - **2026-08-24** `bc5eae2eb212`: 4 info - **2026-08-19** `1ad91026000b`: 2 warning, 21 info - **2026-07-26** `463db127267a`: 1 info ## Changes - **2026-10-22** `549f4adbbfcf`: 33 breaking, 11 info - the response's body type changed from `object` to no type for status `400` - the response's body type changed from `object` to no type for status `401` - the response's body type changed from `object` to no type for status `403` - the response's body type changed from `object` to no type for status `404` - the response's body type changed from `object` to no type for status `409` - the response's body type changed from `object` to no type for status `410` - the response's body type changed from `object` to no type for status `422` - the response's body type changed from `object` to no type for status `429` - the response's body type changed from `object` to no type for status `500` - the response's body type changed from `object` to no type for status `502` - the response's body type changed from `object` to no type for status `503` - removed the required property `error` from the response with the `400` status - removed the required property `error` from the response with the `401` status - removed the required property `error` from the response with the `403` status - removed the required property `error` from the response with the `404` status - removed the required property `error` from the response with the `409` status - removed the required property `error` from the response with the `410` status - removed the required property `error` from the response with the `422` status - removed the required property `error` from the response with the `429` status - removed the required property `error` from the response with the `500` status - removed the required property `error` from the response with the `502` status - removed the required property `error` from the response with the `503` status - removed the required property `success` from the response with the `400` status - removed the required property `success` from the response with the `401` status - removed the required property `success` from the response with the `403` status - removed the required property `success` from the response with the `404` status - removed the required property `success` from the response with the `409` status - removed the required property `success` from the response with the `410` status - removed the required property `success` from the response with the `422` status - removed the required property `success` from the response with the `429` status - removed the required property `success` from the response with the `500` status - removed the required property `success` from the response with the `502` status - removed the required property `success` from the response with the `503` status - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `400` - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `401` - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `403` - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `404` - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `409` - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `410` - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `422` - …4 more - **2026-10-22** `0d86cfdab3a4`: 2 info - added the new optional request property `likeCompanies` - added the optional property `notFoundNote` to the response with the `200` status - **2026-10-21** `d04cdb8563c3`: 4 info - added the optional property `contacts/items/employer/founded` to the response with the `200` status - added the optional property `employerFacts` to the response with the `200` status - added the optional property `employerNote` to the response with the `200` status - added the optional property `sizeUnknownPeople/items/employer/founded` to the response with the `200` status - **2026-10-03** `e8a9550eb535`: 10 warning, 28 info - removed the request property `approveLinkedInSpend` - removed the request property `chain` - removed the request property `companySize` - removed the optional property `approvedBy` from the response with the `200` status - removed the optional property `contacts/items/lane` from the response with the `200` status - removed the optional property `contacts/items/networkDistance` from the response with the `200` status - removed the optional property `honoured` from the response with the `200` status - removed the optional property `linkedinSearches` from the response with the `200` status - removed the optional property `needs` from the response with the `200` status - added the new `wants-a-plan` enum value to the `refused` response property for the response status `200` - added the new optional request property `filters/employees` - added the new optional request property `filters/excludeCompanies` - added the new optional request property `filters/monthsInRole` - added the new optional request property `like` - added the new optional request property `perCompany` - the request property `filters` became optional - the `filters` request property default value `{}` was added - added the optional property `allAlreadyInList` to the response with the `200` status - added the optional property `alreadyInListNote` to the response with the `200` status - added the optional property `contacts/items/employer` to the response with the `200` status - added the optional property `contacts/items/positions/items/endDate/month` to the response with the `200` status - added the optional property `contacts/items/positions/items/startDate/month` to the response with the `200` status - added the optional property `coverage` to the response with the `200` status - added the optional property `excludedByWords` to the response with the `200` status - added the optional property `exclusionFilter` to the response with the `200` status - added the optional property `exclusionNote` to the response with the `200` status - added the optional property `likeNote` to the response with the `200` status - added the optional property `lookalikes` to the response with the `200` status - added the optional property `namedCompanies` to the response with the `200` status - added the optional property `namedCompaniesNote` to the response with the `200` status - added the optional property `planNote` to the response with the `200` status - added the optional property `respelledNote` to the response with the `200` status - added the optional property `roleNote` to the response with the `200` status - added the optional property `roleStart` to the response with the `200` status - added the optional property `sizeFilter` to the response with the `200` status - added the optional property `sizeNote` to the response with the `200` status - added the optional property `sizeUnknownPeople` to the response with the `200` status - added the optional property `unreadable` to the response with the `200` status - **2026-09-18** `4461a51fb989`: 5 breaking, 8 warning, 4 info - the `limit` request property's max was decreased to `100.00` - removed the required property `axesTried/items/attempted` from the response with the `200` status - removed the required property `axesTried/items/exhausted` from the response with the `200` status - removed the required property `axesTried/items/queriesPlanned` from the response with the `200` status - removed the required property `axesTried/items/yielded` from the response with the `200` status - removed the optional property `askedFor` from the response with the `200` status - removed the optional property `companies` from the response with the `200` status - removed the optional property `countryRiskNote` from the response with the `200` status - removed the optional property `partial` from the response with the `200` status - removed the optional property `progress` from the response with the `200` status - removed the optional property `stillRunning` from the response with the `200` status - removed the optional property `union` from the response with the `200` status - added the new `off-topic` enum value to the `refused` response property for the response status `200` - added the optional property `timedOut` to the response with the `200` status - added the required property `axesTried/items/found` to the response with the `200` status - added the required property `axesTried/items/fresh` to the response with the `200` status - added the required property `axesTried/items/queries` to the response with the `200` status - **2026-09-01** `9e9922f867ad`: 1 info - added the optional property `listTotal` to the response with the `200` status - **2026-08-28** `62bf7284843d`: 2 breaking, 20 info - request property `save` was restricted to a list of enum values - the `save` request property type changed from `boolean` to `string` - added the new optional request property `approveLinkedInSpend` - added the new optional request property `excludeProfiles` - added the new optional request property `excludeWords` - the request property `save` became optional - the `save` request property default value `keep` was added - added the new `ask` enum value to the request property `save` - added the new `keep` enum value to the request property `save` - added the new `skip` enum value to the request property `save` - added the optional property `approvedBy` to the response with the `200` status - added the optional property `contacts/items/lane` to the response with the `200` status - added the optional property `contacts/items/networkDistance` to the response with the `200` status - added the optional property `contacts/items/publicIdentifier` to the response with the `200` status - added the optional property `excludedCount` to the response with the `200` status - added the optional property `exhaustionNote` to the response with the `200` status - added the optional property `honoured` to the response with the `200` status - added the optional property `laneNote` to the response with the `200` status - added the optional property `linkedinSearches` to the response with the `200` status - added the optional property `needs` to the response with the `200` status - added the optional property `saved/decide` to the response with the `200` status - added the optional property `union` to the response with the `200` status - **2026-08-27** `d5f1141f87e3`: 1 breaking, 11 warning, 22 info - the request property `save` became required - 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` - added the new optional request property `companyHQ` - added the new optional request property `companySize` - added the new optional request property `connectionDegree` - added the new optional request property `followersOf` - added the new optional request property `pastCompanies` - added the new optional request property `profileLanguage` - added the new optional request property `school` - added the new optional request property `verified` - the `save` request property default value `true` was removed - added the optional property `ambiguity` to the response with the `200` status - added the optional property `companies` to the response with the `200` status - added the optional property `creditsExhausted` to the response with the `200` status - added the optional property `creditsUsed` to the response with the `200` status - added the optional property `duplicates` to the response with the `200` status - added the optional property `notSearched` to the response with the `200` status - added the optional property `partial` to the response with the `200` status - added the optional property `poolTargeted` to the response with the `200` status - added the optional property `pooled` to the response with the `200` status - added the optional property `progress` to the response with the `200` status - added the optional property `queries` to the response with the `200` status - added the optional property `saved` to the response with the `200` status - added the optional property `stillRunning` to the response with the `200` status - **2026-08-24** `bc5eae2eb212`: 4 info - added the new optional request property `sentence` - added the optional property `askedFor` to the response with the `200` status - added the optional property `notFound` to the response with the `200` status - added the optional property `refused` to the response with the `200` status - **2026-08-19** `1ad91026000b`: 2 warning, 21 info - removed the optional property `creditsUsed` from the response with the `200` status - removed the optional property `retryAfter` from the response with the `200` status - added the new optional request property `more` - added the optional property `axesAvailable` to the response with the `200` status - added the optional property `axesTried` to the response with the `200` status - added the optional property `contacts/items/badge` to the response with the `200` status - added the optional property `contacts/items/connections` to the response with the `200` status - added the optional property `contacts/items/education` to the response with the `200` status - added the optional property `contacts/items/educations` to the response with the `200` status - added the optional property `contacts/items/followers` to the response with the `200` status - added the optional property `contacts/items/imageUrl` to the response with the `200` status - added the optional property `contacts/items/languages` to the response with the `200` status - added the optional property `contacts/items/positions` to the response with the `200` status - added the optional property `contacts/items/recentPosts` to the response with the `200` status - added the optional property `contacts/items/summary` to the response with the `200` status - added the optional property `countryRiskNote` to the response with the `200` status - added the optional property `exhaustion` to the response with the `200` status - added the optional property `existingCount` to the response with the `200` status - added the optional property `moreAvailable` to the response with the `200` status - added the optional property `searches` to the response with the `200` status - added the optional property `searchesFailed` to the response with the `200` status - added the required property `provider` to the response with the `200` status - added the required property `query` to the response with the `200` status - **2026-07-26** `463db127267a`: 1 info - endpoint added --- [Operation](https://skmtc.dev/berea/apis/bereach-api/docs/public/search/post.md) · [API](https://skmtc.dev/berea/apis/bereach-api.md) · [Page](https://skmtc.dev/berea/apis/bereach-api/changes/public/search/post)