# Companies

## Filter companies

 - [POST /companies/filter](https://docs.mvmnt.io/apis/openapi/companies/filtercompanies.md): Query companies using flexible filter criteria with AND/OR logic.

By default, only non-deleted companies are returned (deletedAt: { isNull: true }).
Override this by explicitly setting deletedAt filter criteria.

## Create a new company

 - [POST /companies](https://docs.mvmnt.io/apis/openapi/companies/createcompany.md): Create a new company within an organization

## Get a company by ID

 - [GET /companies/{id}](https://docs.mvmnt.io/apis/openapi/companies/getcompanybyid.md): Retrieve a single company by its unique identifier

## Update a company

 - [PATCH /companies/{id}](https://docs.mvmnt.io/apis/openapi/companies/updatecompany.md): Partially update a company. Only provided fields will be updated.

- Omitted fields: Not modified (current value preserved)
- Provided fields: Updated to the new value
- Null values: Clear the field (set to null) where applicable

## Delete a company

 - [DELETE /companies/{id}](https://docs.mvmnt.io/apis/openapi/companies/deletecompany.md): Soft delete a company (sets deletedAt timestamp).

The company will no longer appear in default queries but can be retrieved
by explicitly filtering for deleted records.