# 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.

```text
DELETE https://embedded-api.lazyinvoice.co.il/v1/businesses/{biz_id}
```

## Parameters

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `biz_id` | string | Yes | The Lazy ID of the business, returned when the business was created. |

## Responses

### 204 No Content

Deleted. No response body.

## Errors

Every error body is the [error envelope](https://developers.lazyinvoice.co.il/embedded/errors/). Any endpoint can also return 401, 429 and 500; [Errors](https://developers.lazyinvoice.co.il/embedded/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

Safe to retry. A retry after a successful delete gets `404 not_found`; treat that as done.

## Async behavior and events

None. The change is complete when the response arrives, and Lazy sends no webhook for it.

## Examples

### Delete a business

```bash
curl -X DELETE https://embedded-api.lazyinvoice.co.il/v1/businesses/biz_8fKq2LmZp4TnWx7RcV1a \
  -H "Authorization: Bearer $LAZY_API_KEY"
```

Response: `204 No Content`, with no body.

### The business is already deleted

```bash
curl -X DELETE https://embedded-api.lazyinvoice.co.il/v1/businesses/biz_8fKq2LmZp4TnWx7RcV1a \
  -H "Authorization: Bearer $LAZY_API_KEY"
```

Response: `404 Not Found`

```json
{
  "error": {
    "code": "not_found",
    "message": "Business not found",
    "request_id": "q8Zr1Ndk2vLp0Xw7HcYt3Rb9Fs6Mj4Ge5Ua1Ki8Oy2Wn0Tz7Ql3Px=="
  }
}
```

Added in: [October 2026](https://developers.lazyinvoice.co.il/embedded/changelog/#october-2026)