Get a business

View as Markdown

Returns one business of your platform by its biz_id. To look a business up by your own ID instead, use List businesses with external_id.

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.

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.

Retry safety

Safe to retry. It changes nothing.

Async behavior and events

None. This endpoint only reads.

Added in: October 2026

Examples

Get a business
The business does not exist

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

Response: 200 OK

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

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

Response: 404 Not Found

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