---
title: "GET /assets/{assetId}/properties"
method: GET
path: "/assets/{assetId}/properties"
---

# GET /assets/{assetId}/properties

`GET /assets/{assetId}/properties`

Retrieves a paginated list of properties associated with an asset. If you update properties associated with the model before you finish listing all the properties, you need to start all over again.

## Path parameters

- `assetId` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer
- `filter` 'ALL' | 'BASE'

## Response `200`

Success

- ListAssetPropertiesResponse
  - `assetPropertySummaries` AssetPropertySummary[], required — A list that summarizes the properties associated with the specified asset.
    - `id` string — The ID of the property.
    - `alias` string — The alias that identifies the property, such as an OPC-UA server data stream path (for example, <code>/company/windfarm/3/turbine/7/temperature</code>). For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html">Mapping industrial data streams to asset properties</a> in the <i>IoT SiteWise User Guide</i>.
    - `unit` string — The unit of measure (such as Newtons or RPM) of the asset property.
    - `notification` PropertyNotification — Contains asset property value notification information. When the notification state is enabled, IoT SiteWise publishes property value updates to a unique MQTT topic. For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html">Interacting with other services</a> in the <i>IoT SiteWise User Guide</i>.
      - `topic` string, required — The MQTT topic to which IoT SiteWise publishes property value update notifications.
      - `state` 'ENABLED' | 'DISABLED', required — The current notification state.
    - `assetCompositeModelId` string — The ID of the composite model that contains the asset property.
  - `nextToken` string — The token for the next set of results, or null if there are no additional results.

## Other responses

- `480` — InvalidRequestException
- `481` — InternalFailureException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/iotsitewise.md) · [All operations](https://skmtc.net/aws/apis/iotsitewise/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotsitewise/versions/d13e5d3e0a6f/schema)