# Get a business

Returns one business of your platform by its `biz_id`. To look a business up by your own ID instead,
use [List businesses](https://developers.lazyinvoice.co.il/embedded/api/businesses/list/) with `external_id`.

```text
GET 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

### 200 OK

The business. The body is a [Business object](https://developers.lazyinvoice.co.il/embedded/objects/businesses/).

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

## Retry safety

Safe to retry. It changes nothing.

## Async behavior and events

None. This endpoint only reads.

## Examples

### Get a business

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

Response: `200 OK`

```json
{
  "biz_id": "biz_8fKq2LmZp4TnWx7RcV1a",
  "external_id": "customer-1042",
  "name": "Dana Levi Design",
  "created_at": "2026-10-02T09:14:03.512874+00:00"
}
```

### The business does not exist

```bash
curl https://embedded-api.lazyinvoice.co.il/v1/businesses/biz_Zz9Yy8Xx7Ww6Vv5Uu4Tt \
  -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)