---
title: "Changes to Find companies from public data"
method: POST
path: "/public/companies"
---

# Changes to Find companies from public data

`POST /public/companies`

> 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, 12 info
- **2026-10-21** `d04cdb8563c3`: 1 info
- **2026-10-21** `50dee7c64a4b`: 1 info
- **2026-10-21** `25c426807c4e`: 1 info
- **2026-10-03** `e8a9550eb535`: 12 info
- **2026-09-18** `4461a51fb989`: 2 breaking, 5 info
- **2026-08-28** `ee1b63eb6645`: 3 info
- **2026-08-27** `d5f1141f87e3`: 11 warning
- **2026-08-20** `9217eedacbb8`: 1 info
- **2026-08-19** `1ad91026000b`: 2 warning, 2 info
- **2026-07-26** `463db127267a`: 1 info

## Changes

- **2026-10-22** `549f4adbbfcf`: 33 breaking, 12 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`
  - …5 more
- **2026-10-21** `d04cdb8563c3`: 1 info
  - added the new optional request property `sentence`
- **2026-10-21** `50dee7c64a4b`: 1 info
  - added the optional property `note` to the response with the `200` status
- **2026-10-21** `25c426807c4e`: 1 info
  - added the optional property `companies/items/linkedin` to the response with the `200` status
- **2026-10-03** `e8a9550eb535`: 12 info
  - added the new optional request property `filters/employees`
  - added the new optional request property `filters/excludeCompanies`
  - added the new optional request property `filters/fundedWithinMonths`
  - added the optional property `companies/items/latestRound` 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 `fundingFilter` to the response with the `200` status
  - added the optional property `fundingNote` to the response with the `200` status
  - added the optional property `namedNote` 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 required property `companies/items/imageUrl` to the response with the `200` status
- **2026-09-18** `4461a51fb989`: 2 breaking, 5 info
  - removed the required property `companies/items/companyUrl` from the response with the `200` status
  - removed the required property `companies/items/slug` from the response with the `200` status
  - added the required property `companies/items/city` to the response with the `200` status
  - added the required property `companies/items/country` to the response with the `200` status
  - added the required property `companies/items/employees` to the response with the `200` status
  - added the required property `companies/items/foundedYear` to the response with the `200` status
  - added the required property `companies/items/website` to the response with the `200` status
- **2026-08-28** `ee1b63eb6645`: 3 info
  - added the new optional request property `more`
  - added the optional property `duplicates` to the response with the `200` status
  - added the required property `moreAvailable` to 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 required property `companies/items/description` to the response with the `200` status
- **2026-08-19** `1ad91026000b`: 2 warning, 2 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 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/companies/post.md) · [API](https://skmtc.dev/berea/apis/bereach-api.md) · [Page](https://skmtc.dev/berea/apis/bereach-api/changes/public/companies/post)
