# Customers

## Filter customers

 - [POST /customers/filter](https://docs.mvmnt.io/apis/openapi/customers/filtercustomers.md): Filter customers using comprehensive query criteria with AND/OR logic and multiple operators.
Supports complex filtering similar to GraphQL capabilities.
Note: Soft-deleted customers are excluded by default (deletedAt defaults to { isNull: true }).

## Create customer

 - [POST /customers](https://docs.mvmnt.io/apis/openapi/customers/createcustomer.md): Create a new customer in your organization

## Get customer

 - [GET /customers/{id}](https://docs.mvmnt.io/apis/openapi/customers/getcustomer.md): Retrieve a customer by ID or client key

## Update customer

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

## Delete customer

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

## Search customers

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

This endpoint provides fast, indexed search across customer 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) customers 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 customer objects with all relationships