Delete a business
Deletes a business permanently. This cannot be undone: there is no way to restore the business.
Afterwards every request with its biz_id gets 404 not_found, and its external_id is free to use
for a new business.
Lazy bills your platform for the business’s days in the current month before the day you delete it.
DELETE https://embedded-api.lazyinvoice.co.il/v1/businesses/{biz_id}Parameters
Section titled “Parameters”Path parameters
Section titled “Path parameters”| Name | Type | Required | Description |
|---|---|---|---|
biz_id |
string | Yes | The Lazy ID of the business, returned when the business was created. |
Responses
Section titled “Responses”204 No Content
Section titled “204 No Content”Deleted. No response body.
Errors
Section titled “Errors”Every error body is the error envelope. Any endpoint can also return 401, 429 and 500; Errors explains them.
| Status | Code, cause and what to do |
|---|---|
| 400 | validation_error: an unknown query parameter. Fix the request; param names the field at fault when there is one. |
| 404 | not_found: no business with this biz_id belongs to your platform. Check the biz_id; a deleted business stays not found. |
| 409 | billing_not_ready: your platform has no billing account; contact Lazy. |
Retry safety
Section titled “Retry safety”Safe to retry. A retry after a successful delete gets 404 not_found; treat that as done.
Async behavior and events
Section titled “Async behavior and events”None. The change is complete when the response arrives, and Lazy sends no webhook for it.
Added in: October 2026