List inventory transactions

GET 
/inventory/transactions

Returns a paginated ledger of inventory transactions. Every stock movement in Keychain OS is recorded as a transaction: intake (received from a PO), outtake (consumed by a work order or shipped on a sales order), adjustment (manual correction), move (transfer between warehouse locations), or return (sent back to a vendor). Each transaction references the source record (PO, work order, etc.) so you can trace every unit back to its origin. Filter by type, inventory code, date range, or reference to narrow the results.

Request

Response

200

Paginated inventory transactions

400

Bad request — invalid parameters

401

Unauthorized — missing or invalid API key

Response

{
  "data": [
    {
      "transactionId": "TXN-00892",
      "type": "intake",
      "inventoryCode": "INV-000312",
      "itemName": "Organic Tahini",
      "quantity": 200,
      "unit": "lbs",
      "referenceType": "purchase_order",
      "referenceId": "PO-2025-0471",
      "purpose": null,
      "reason": null,
      "notes": null,
      "timestamp": "2025-03-15T10:45:00Z"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "total": 87
  }
}