# Vendors

## Filter vendors

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

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

## Create a new vendor

 - [POST /vendors](https://docs.mvmnt.io/apis/openapi/vendors/createvendor.md): Create a new vendor within an organization.

Vendors represent service providers (warehousing, storage, etc.) that are not carriers.

## Get a vendor by ID

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

## Update a vendor

 - [PATCH /vendors/{id}](https://docs.mvmnt.io/apis/openapi/vendors/updatevendor.md): Partially update a vendor. 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 vendor

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

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

## Search vendors

 - [POST /vendors/search](https://docs.mvmnt.io/apis/openapi/vendors/searchvendors.md): Search vendors using OpenSearch-powered full-text and field-specific search.

This endpoint provides fast, indexed search across vendor data with support for:
- Full-text search across multiple fields
- Field-specific filtering with various operators
- Sorting and pagination
- Saved search preferences

Note: Only active (non-deleted) vendors are searchable. Soft-deleted records are automatically excluded from all search results.

Response Formats:
- flat (default): Returns indexed fields only for faster performance
- full: Returns complete vendor objects with all relationships