---
title: "How do I retrieve a time-variant property as a time-series?"
slug: "how-do-i-retrieve-a-time-variant-property-as-a-time-series"
updated: 2024-09-04T13:23:00Z
published: 2024-09-04T13:23:00Z
canonical: "support.lusid.com/how-do-i-retrieve-a-time-variant-property-as-a-time-series"
---

> ## 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.

# How do I retrieve a time-variant property as a time-series?

Providing you have suitable [access control permissions](/v1/docs/introduction-to-identity-management-and-access-control), you can retrieve a time-variant property as a time-series for certain types of entity. [See how to retrieve properties normally](/v1/docs/how-do-i-retrieve-a-property-or-derived-property-for-an-entity).

> **Note**: A time-variant property is one whose [property type](/v1/docs/how-do-i-create-a-property-type) has a `lifeTime` of `TimeVariant`. It can be single- or multi-value.

For example, imagine you have a `Person/Manager/Address` property attached to a particular person with different values effective during the following time periods:

| **Property value** | **Effective from** | **Effective until** |
| --- | --- | --- |
| 1 Main Street | 1 January 2019 | 1 January 2020 |
| 2 High Street | 1 January 2020 | 1 January 2021 |
| 3 Station Street | 1 January 2021 | now |

To retrieve all the historical values of this property you would normally need to make three requests, one during each of the time periods. Instead, you can make one request and receive a time-series containing all the values together. [More information on this scenario](/v1/docs/understanding-perpetual-and-time-variant-properties).

You can currently retrieve a property as a time series for the following types of entity:

- [Instruments](https://www.lusid.com/docs/api#operation/GetInstrumentPropertyTimeSeries)
- [Legal entities](https://www.lusid.com/docs/api#operation/GetLegalEntityPropertyTimeSeries)
- [Persons](https://www.lusid.com/docs/api#operation/GetPersonPropertyTimeSeries)
- [Portfolios](https://www.lusid.com/docs/api#operation/GetPortfolioPropertyTimeSeries)
- [Portfolio groups](https://www.lusid.com/docs/api#operation/GetPortfolioGroupPropertyTimeSeries)

## Using the LUSID REST API

To retrieve a time-variant `Person/Manager/Address` property for a particular person as a time-series:

1. [Obtain an API access token](/v1/docs/how-do-i-obtain-and-use-a-short-lived-api-access-token-from-okta).
2. Call the [GetPersonPropertyTimeSeries](https://www.lusid.com/docs/api#operation/GetPersonPropertyTimeSeries) API for your LUSID domain, passing in your API access token and the 3-stage key of the property to retrieve, for example:

```json
 curl -X GET "https://<your-domain>.lusid.com/api/persons/Traders/TraderId/Trader5/properties/time-series?propertyKey=Person%2FManager%2FAddress"
   -H "Authorization: Bearer <your-API-access-token>"
```

The response is as follows (for clarity, shown as table ouput from the equivalent method in the LUSID Python SDK):

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/84cf4b20-92cc-4dbe-86e2-b4e09dc51bb1.png)

Note there are two values for each of 1 Main Street and 2 High Street, with a status of `superseded` and `prevailing` respectively. This is because each address was originally attached to the person without an effective until date. So for example 1 Main Street was initially upserted effective 1 January 2019 until the end of time; when 2 High Street was subsequently upserted effective 1 January 2020, LUSID automatically reset the effective until date of 1 Main Street to 1 January 2020.

To retrieve just the prevailing values for each time period, specify a [filter](/v1/docs/filtering-information-retrieved-from-lusid) of `status eq 'Prevailing'`, for example:

```json
curl -X GET "https://<your-domain>.lusid.com/api/persons/Traders/TraderId/Trader5/properties/time-series?propertyKey=Person%2FManager%2FAddress&filter=status%20eq%20%27Prevailing%27"
-H "Authorization: Bearer <your-API-access-token>"
```

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/664460fc-a19d-4fb7-ad7a-712ecda1b91f.png)

## Using the LUSID web app

*Coming soon.*