# Get a business's usage and limits

Returns a business's [usage](https://developers.lazyinvoice.co.il/embedded/objects/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](https://developers.lazyinvoice.co.il/embedded/retries/).

```text
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](https://developers.lazyinvoice.co.il/embedded/objects/usage/).

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

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

Response: `200 OK`

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

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