---
title: "Retrieving version information for entities"
slug: "retrieving-version-information-and-tracking-changes"
updated: 2026-04-24T07:59:35Z
published: 2026-04-24T07:59:35Z
canonical: "support.lusid.com/retrieving-version-information-and-tracking-changes"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieving version information for entities

LUSID stores version information for most types of entity. [See how to audit change history](/v1/docs/auditing-entity-change-history).

For example, a call to the [GetPortfolio](https://www.lusid.com/docs/api/lusid/endpoints/portfolios/GetPortfolio) API for a portfolio identified by a particular scope and code returns a `version` object:

```json
{ 
  "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",
  ...
  }
}
```

> [!WARNING]
> **Important**: Ignore the deprecated `version.effectiveFrom` and `version.asAtDate` fields. Instead, use:
> 
> - `version.asAtCreated` for the date at which the first version of the entity begins.
> - `version.asAtModified` for the date at which the current version begins.

Note the following:

- The `asAtVersionNumber` of a newly-created entity is `1`, so the example portfolio above has been modified five times. [See every change to every version](/v1/docs/auditing-entity-change-history).
- You can use `requestIdCreated`/`requestIdModified` to look up more information about the underlying API request from the [Insights](/v1/docs/troubleshooting-a-failed-request-using-the-insights-service#using-request-logs-to-examine-api-requests-and-responses) service.
- You can use `userIdCreated`/`userIdModified` to look up more information about the responsible user from the [Identity](https://www.lusid.com/docs/api/identity/endpoints/users/GetUser) service.
- `reasonCreated`/`reasonModified` is only likely to be populated if the version is a [staged modification](/v1/docs/staging-changes-for-approval) awaiting approval.
- You can filter most types of entity by version fields. [More information](/v1/docs/filtering-information-retrieved-from-lusid#filtering-entities-based-on-version-information).
- [Quotes](/v1/docs/market-data) and [transactions](/v1/docs/transactions) do not have a `version` object; instead, information is provided by:
  - For transactions, the `entryDateTime` field.
  - For quotes, the `uploadedBy` and `asAt` fields.

### Getting notified about changes

You can subscribe to system events to get notified when entities are created, updated or deleted. For example, the following call to the [CreateSubscription](https://www.lusid.com/docs/api/notification/endpoints/subscriptions/CreateSubscription) API subscribes to the `PortfolioUpdated` system event for any portfolio in the `Equities` scope by any user other than one:

```json
curl -X POST "https://<your-domain>.lusid.com/notification/api/subscriptions"
  -H "Authorization: Bearer <your-API-access-token>"
  -d "{
  "id": {
    "scope": "MySubscriptions",
    "code": "PortfolioUpdates"
  },
  "displayName": "PortfolioUpdatesByOtherUsers",
  "description": "Subscribes to all PortfolioUpdated events where the user performing the update is not me.",
  "status": "Active",
  "matchingPattern": {
    "eventType": "PortfolioUpdated",
    "filter": "Header.userId neq '00uji4twb4jDcHGjN2p8' and Body.portfolioScope eq 'Equities'"
  }
}"
```

[Learn more about the Notification Service](/v1/docs/notification-service).