# Create Purchase Order

**POST** `/v1/inventory/purchase-orders`

Creates a purchase order with line items. The PO starts in `draft` status. Update its status to `sent` when the order is placed with the supplier.

### Request fields

| Field | Type | Required | Description |
|---|---|---|---|
| `location_id` | integer | Yes | Receiving location for this PO |
| `items` | array | Yes | Line items (min 1) |
| `items[].listing_id` | integer | Yes | Listing being ordered |
| `items[].quantity_ordered` | integer | Yes | Units ordered |
| `items[].unit_cost` | float | No | Cost per unit |
| `supplier` | string | No | Supplier name |
| `reference` | string | No | External PO number |
| `note` | string | No | Notes |
| `expected_at` | timestamp | No | Expected delivery date |

### Response fields

| Field | Type | Description |
|---|---|---|
| `purchase_order` | object | The created PO with its line items |