Customers

Delete a customer

Deletes a customer that has no invoices.

  • Deprecated: use DELETE /v1/companies/{company_id}/customers/{customer_id}, which deletes the same way but answers 204 with no body instead of 200. This route keeps working until the date announced in its Sunset response header.

What deleting means

  • No longer exposed: the customer is retained internally for tax record-keeping purposes, but is no longer exposed by the API: subsequent requests to it return 404, and it is never included in the customer list, under any value of the active filter.
  • Identifier released: its NIF or alternative identifier is freed, so a new customer may be created with the same identifier.

Customers you cannot delete

  • Customers with invoices: they cannot be deleted and the request answers 409 CLIENT_HAS_INVOICES, leaving the customer untouched — neither deleted nor deactivated.
  • Customers used by a recurring invoice: while an active or paused recurring invoice has the customer as its recipient, the request answers 400 REFERENCED_BY_RECURRING_INVOICE.
  • Deactivating instead: to stop using a customer, whether or not it has invoices, update it with active set to false: that releases no identifier and keeps the customer retrievable through GET /v1/customers?active=false.

Retires on 9 December 2026. See the migration guide for what moved where and what changes when you switch.

delete/v1/customers/{customer_id}

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/customers/{customer_id}
  • Auth: HTTP bearer

Path parameters

customer_idstring uuid required

Universally Unique Identifier (UUID v4)

Example:550e8400-e29b-41d4-a716-446655440000

Customer ID

Response

Customer deleted successfully

successboolean required

Example response

{
  "success": true,
  "data": {
    "message": "Customer deleted successfully"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.