# customers

Receivables master data — the businesses that pay you.

 - [GET /customers](https://developer.boyahq.com/v2/openapi/customers/customerscontroller_listcustomers.md): Returns customers associated with the business. By default returns only ACTIVE customers; pass ?status=DELETED to list soft-deleted customers or ?status=ALL to list both populations.
 - [POST /customers](https://developer.boyahq.com/v2/openapi/customers/customerscontroller_createcustomer.md): Creates a new customer. - **regular**: only `name` is required. `email`, `phone`, `address`, `taxPin` and `person` are optional. - **walkIn**: only `type` is required. Name is auto-set to "WalkIn" and
 - [GET /customers/{id}](https://developer.boyahq.com/v2/openapi/customers/customerscontroller_getcustomer.md): Fetches a single customer document by its MongoDB ObjectId.
 - [PUT /customers/{id}](https://developer.boyahq.com/v2/openapi/customers/customerscontroller_updatecustomer.md): Updates an active regular customer. Walk-In customers are immutable and cannot be edited.
 - [DELETE /customers/{id}](https://developer.boyahq.com/v2/openapi/customers/customerscontroller_deletecustomer.md): Marks an active customer as deleted. The record is retained but excluded from all active customer queries.
 - [PATCH /customers/{id}/reactivate](https://developer.boyahq.com/v2/openapi/customers/customerscontroller_reactivatecustomer.md): Flips a soft-deleted customer back to ACTIVE. Idempotent: calling on an already-active customer is a no-op.
 - [GET /customers/search](https://developer.boyahq.com/v2/openapi/customers/customerscontroller_searchcustomers.md): Full-text search across customer name, phone, and email. Returns up to 10 active matches.