# Usage

Each business has a monthly document allowance and a limit on how far back Lazy scans its email.
Your contract with Lazy sets both. You can read a business's usage at any time and raise either limit
for one business. Purchases are billed to your platform in its next monthly bill.

## Objects

- [Usage object](https://developers.lazyinvoice.co.il/embedded/objects/usage/): documents used this period, and the two limits.

## Endpoints

| Endpoint                                                   | Request                                            |
| ---------------------------------------------------------- | -------------------------------------------------- |
| [Get usage](https://developers.lazyinvoice.co.il/embedded/api/usage/get/)                      | `GET /v1/businesses/{biz_id}/usage`                |
| [Top up documents](https://developers.lazyinvoice.co.il/embedded/api/usage/top-up/)            | `POST /v1/businesses/{biz_id}/upgrade/top-up`      |
| [Extend the scan period](https://developers.lazyinvoice.co.il/embedded/api/usage/scan-period/) | `POST /v1/businesses/{biz_id}/upgrade/scan-period` |

Purchases are not safe to send twice. Before you build a retry around them, read
[Retries and idempotency](https://developers.lazyinvoice.co.il/embedded/retries/#purchases-top-ups-and-scan-period-extensions).