Auditing change history for entities

LUSID stores a complete change history for entities of particular types, with more to follow.

Entity type	Fields and properties together	Just properties on their own
Portfolio	✅ Try API (requires `entityUniqueId`)	✅ Try API
PortfolioGroup	❌	✅ Try API
Fund	✅ Try API (requires `entityUniqueId`)	❌
Order-related entities `Order`, `Allocation`, `Block`, `Execution`, `OrderInstruction`, `Package`, `Participation`, `Placement`	✅ Try API (requires `entityUniqueId`)	❌
Instrument	❌	✅ Try API
Transaction	✅ Try API	❌
LegalEntity	❌	✅ Try API
Person	❌	✅ Try API

To obtain an entityUniqueId, retrieve version information for the entity whose change history you want to examine.

For example, a call to the GetPortfolio API for a particular portfolio identified by scope and code reveals a version.entityUniqueId of 668bbeef-55d8-4f0a-a3ff-803de058ab75:

{ 
  "id": {
    "scope": "Equities",
    "code": "US-Growth"
  },
  "type": "Transaction",
  "displayName": "Instructed settlement portfolio",
  "created": "2025-01-01T00:00:00.0000000+00:00",
  "version": {
    "effectiveFrom": "2026-04-21T08:02:21.9248910+00:00",
    "asAtDate": "2026-04-21T08:02:21.7861670+00:00",
    "asAtCreated": "2026-04-09T10:28:32.4468080+00:00",
    "userIdCreated": "00u91lo2d7X42sfse2p7",
    "requestIdCreated": "2026040910-b05f687e721f476fb894455780399f12",
    "reasonCreated": "",
    "asAtModified": "2026-04-20T11:35:59.0394510+00:00",
    "userIdModified": "00u91lo2d7X42sfse2p7",
    "requestIdModified": "2026042011-d26f7daf9a24444c80e8f6c6ea189d09",
    "reasonModified": "",
    "asAtVersionNumber": 6,
    "entityUniqueId": "668bbeef-55d8-4f0a-a3ff-803de058ab75"
  },
  "isDerived": false,
  "baseCurrency": "GBP",
  ...
  }
}

Note also the asAtVersionNumber of 6, which means this entity has been created (first modification) and then modified five times.