---
title: "GET /dataAssets"
method: GET
path: "/dataAssets"
tags: ["DataAsset"]
---

# GET /dataAssets

`GET /dataAssets`

## Request

- Base URL: `{endpoint}/datagovernance/catalog`
- URL: `{endpoint}/datagovernance/catalog/dataAssets`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `https://purview.azure.net/.default`

Lists data assets with optional ordering and pagination. Rate limit: 150 requests per 20-second window.

## Query parameters

- `api-version` string, required
- `includeExtendedProperties` boolean, required
- `orderBy` string
- `skip` integer
- `top` integer

## Response `200`

The request has succeeded.

- PagedDataAsset: Paged collection of DataAsset items
  - `value` DataAsset[], required: The DataAsset items on this page
    - `id` string, uuid, required: Universally Unique Identifier
    - `name` string, required: Name of the data asset.
    - `systemData` DataAssetSystemData: System metadata with expiration information for data assets.
      - `provisioningState` 'Unknown' | 'Succeeded' | 'SoftDeleted': The provisioning state of a data asset.
      - `createdAt` string, date-time: The timestamp when the record was created.
      - `createdBy` string, uuid: Universally Unique Identifier
      - `lastModifiedAt` string, date-time: The timestamp when the record was last modified.
      - `lastModifiedBy` string, uuid: Universally Unique Identifier
      - `expiredAt` string, date-time: The timestamp when the record expires.
      - `expiredBy` string, uuid: Universally Unique Identifier
    - `description` string: A description about the relationship.
    - `source` CatalogModelDataAssetSource: Source information for data assets.
      - `type` string: The type of the data asset source.
      - `assetId` string, uuid: Universally Unique Identifier
      - `assetType` string: Data map asset type. Example: adls_gen2_path, azure_sql_table, etc.
      - `assetAttributes` string[]: Type properties of the asset.
      - `fqn` string: Fully qualified name of the data asset.
      - `accountName` string: The data map account name of the data asset.
      - `lastRefreshedAt` string, date-time: Date of the last sync time.
      - `lastRefreshedBy` string: ID of the user who last refreshed the asset.
    - `contacts` ContactsMap: A dictionary of contact lists keyed by contact type (e.g., 'Owner', 'Expert').
      - `owner` CatalogModelContactsValueInner[]: List of owner contacts.
        - `id` string, uuid: Universally Unique Identifier
        - `description` string: A description of this user assignment
      - `expert` CatalogModelContactsValueInner[]: List of expert contacts.
        - `id` string, uuid: Universally Unique Identifier
        - `description` string: A description of this user assignment
      - `databaseAdmin` CatalogModelContactsValueInner[]: List of database administrator contacts.
        - `id` string, uuid: Universally Unique Identifier
        - `description` string: A description of this user assignment
    - `classifications` string[]: A list of classification labels.
    - `type` 'AzureSqlTable' | 'ADLSGen2Path' | 'General', required: The type of a data asset.
    - `schema` CatalogModelDataAssetSchema[]: Schema of the asset.
      - `name` string: Name of the asset.
      - `description` string: Description of the asset.
      - `classifications` string[]: A list of classification labels. example: [PII, PHI]
      - `type` string: Type of the asset.
    - `openInUrl` string, uri: A redirection link.
  - `nextLink` string, uri: The link to the next page of items

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2025-09-15-preview) `70d32c954a8c`: 1 info
  - endpoint added
- **2025-10-01** (2025-09-15-preview) `a588e84c8390`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog/changes/dataAssets/get.md)

---

[API](https://skmtc.dev/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog.md) - [All operations](https://skmtc.dev/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog/revisions/70d32c954a8c?raw)