Get a business's usage and limits

Get a business's usage and limits

Copy for LLMView as Markdown

Returns a business’s usage: how many documents it used since the current monthly period started, and its limits. Read it before a purchase, and again after one whose response you lost; see Retries and idempotency.

GET https://embedded-api.lazyinvoice.co.il/v1/businesses/{biz_id}/usage

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’s usage and limits. The body is a Usage 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 usage

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

Response: 200 OK

{
  "reset_at": "2026-10-02T09:14:03.601127+00:00",
  "used_docs": 12,
  "max_docs": 65,
  "max_email_scan_days": 365
}