# list_orders

> List the account's orders, newest first — by default the open ones (unpaid proforma invoices, each with a `paymentUrl`); pass `status` `paid` for orders that have…

- Tier: R
- Required scope: read:orders
- Annotations: readOnlyHint, idempotentHint
- Docs: https://api.inleed.com/tools/list-orders

## Description

List the account's orders, newest first — by default the open ones (unpaid proforma invoices, each with a `paymentUrl`); pass `status` `paid` for orders that have been paid (each is now a real invoice: `paidAt` is set and `orderId` is the new invoice id — the proforma id is gone once paid) or `all` for both. Each row carries `orderId`, `ocr`, `status`, totals, `paidAt` and `provisioning[]` progress. For one order's full detail use `get_order`; to cancel an unpaid one use `cancel_order`; these are store orders, not invoices in general — for every invoice use `list_invoices`.

## Input schema

- `status` — enum. Which orders: open (unpaid proformas, the default), paid (orders that went through — real invoices with paidAt), or all. One of open, paid, all.
- `limit` — integer. Page size, 1–100, default set by the server. Range 1–100.
- `cursor` — integer. Pagination cursor from a previous page's nextCursor. Omit for the first page. Minimum 0.

## Example call

```json
{
  "name": "list_orders",
  "arguments": {}
}
```