# List Goods Receipt Notes

**GET** `/v1/inventory/grn`

Returns all Goods Receipt Notes (GRNs) for the tenant. A GRN represents one delivery event — it may be linked to a Purchase Order or created standalone. Each GRN contains boxes (individual scanned units).

### Query parameters

| Field | Type | Description |
|---|---|---|
| `status` | string | Filter by status: `open`, `partial`, `closed` |
| `purchase_order_id` | integer | Filter by linked PO |

### Response fields

| Field | Type | Description |
|---|---|---|
| `grns` | array | List of GRN objects |
| `grns[].id` | integer | GRN ID |
| `grns[].status` | string | `open` → `partial` → `closed` |
| `grns[].reference` | string | Delivery note / DO number |
| `grns[].location` | object | Destination warehouse location |
| `grns[].purchase_order_id` | integer | Linked PO (nullable) |