---
title: "Get Tenant Asset (getTenantAsset)"
method: GET
path: "/api/tenant/assets"
tags: ["asset-controller"]
---

# Get Tenant Asset (getTenantAsset)

`GET /api/tenant/assets`

Requested asset must be owned by tenant that the user belongs to. Asset name is an unique property of asset. So it can be used to identify the asset.

Available for users with 'TENANT_ADMIN' authority.

## Query parameters

- `pageSize` integer, required
- `page` integer, required
- `type` string
- `textSearch` string
- `sortProperty` 'createdTime' | 'name' | 'type' | 'label' | 'customerTitle'
- `sortOrder` 'ASC' | 'DESC'
- `assetName` string, required

## Response `200`

OK

- union
  - Asset
    - `id` AssetId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'ASSET', required — string
    - `createdTime` integer — Timestamp of the asset creation, in milliseconds
    - `tenantId` TenantId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'TENANT', required — string
    - `customerId` CustomerId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'CUSTOMER', required — string
    - `name` string, required — Unique Asset Name in scope of Tenant
    - `type` string — Asset type
    - `label` string — Label that may be used in widgets
    - `assetProfileId` AssetProfileId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'ASSET_PROFILE', required — string
    - `version` integer
    - `additionalInfo` unknown
  - PageDataAsset
    - `data` Asset[] — Array of the entities
      - `id` AssetId
        - `id` string, uuid, required — ID of the entity, time-based UUID v1
        - `entityType` 'ASSET', required — string
      - `createdTime` integer — Timestamp of the asset creation, in milliseconds
      - `tenantId` TenantId
        - `id` string, uuid, required — ID of the entity, time-based UUID v1
        - `entityType` 'TENANT', required — string
      - `customerId` CustomerId
        - `id` string, uuid, required — ID of the entity, time-based UUID v1
        - `entityType` 'CUSTOMER', required — string
      - `name` string, required — Unique Asset Name in scope of Tenant
      - `type` string — Asset type
      - `label` string — Label that may be used in widgets
      - `assetProfileId` AssetProfileId
        - `id` string, uuid, required — ID of the entity, time-based UUID v1
        - `entityType` 'ASSET_PROFILE', required — string
      - `version` integer
      - `additionalInfo` unknown
    - `totalPages` integer — Total number of available pages. Calculated based on the 'pageSize' request parameter and total number of entities that match search criteria
    - `totalElements` integer — Total number of elements in all available pages
    - `hasNext` boolean — 'false' value indicates the end of the result set

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)