---
title: "Get List of Data Elements"
method: GET
path: "/inventory/v2/data-elements"
tags: ["Personal Data"]
---

# Get List of Data Elements

`GET /inventory/v2/data-elements`

## Request

- Base URL: `https://customer.my.onetrust.com/api`
- URL: `https://customer.my.onetrust.com/api/inventory/v2/data-elements`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{$$.env.host}/api/access/v1/oauth/token`

Use this API to retrieve the list of all existing Data Elements. 

### Example Request

`GET https://{hostname}/api/inventory/v2/data-elements`

`GET https://trial.onetrust.com/api/inventory/v2/data-elements`

## Query parameters

- `page` number, required
- `size` string

## Response `200`

OK

- OneTrustResponseListDataElementDetailedResponse
  - `data` DataElementDetailedResponse[]
    - `categories` DataCategoryResponse[]
      - `description` string: Description of the Data Category.
      - `descriptionKey` string: Unique key for description of the Data Category.
      - `id` string: Unique Id for the Data Category.
      - `name` string: Name of the Data Category.
      - `nameKey` string: Unique key for name of the Data Category.
    - `classifications` DataClassificationResponse[]
      - `description` string: Description of the Data Classification.
      - `descriptionKey` string: Unique key for description of the Data Classification.
      - `id` string: Unique Id of the Data Classification.
      - `name` string: Name of the Data Classification.
      - `nameKey` string: Unique key for the name of the Data Classification.
    - `description` string: Description of the Data Element.
    - `descriptionKey` string: Unique key for description of the Data Element.
    - `id` string: Unique Id of the Data Element.
    - `name` string: Name of the Data Element.
    - `nameKey` string: Unique key for the name of the Data Element.
  - `errors` object[]
  - `meta` OneTrustMetadata
    - `page` OneTrustPage
      - `first` boolean
      - `last` boolean
      - `number` integer
      - `size` integer
      - `sort` OneTrustSort[]
        - `direction` 'ASC' | 'DESC'
        - `property` string
      - `totalElements` integer
      - `totalPages` integer

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).

---

[API](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation-swagger.md) - [All operations](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation-swagger/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation-swagger/revisions/80794207dfa6?raw)