--- updatedAt: 2026-05-27T12:52:47.000Z agentTools: projectIndex: https://developer.onetrust.com/onetrust/llms.txt --- # Get List of Data Categories Use this API to retrieve a list of all existing Data Categories. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Privacy Automation - Data Mapping Automation", "version": "1.0", "contact": { "name": "OneTrust Support", "url": "https://my.onetrust.com/s/contactsupport" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0" }, "description": "The Data Mapping Automation APIs are used to manage structured records (assets, vendors, processing activities, and legal entities), define schema attributes, traverse parent–child hierarchies, and create cross-record relationships—including links to personal data." }, "servers": [ { "url": "https://{hostname}", "variables": { "hostname": { "default": "hostname", "description": "The OneTrust hostname such as app.onetrust.com, app-eu.onetrust.com, app-de.onetrust.com, app-uk.onetrust.com, app-apac.onetrust.com, trial.onetrust.com, or uat.onetrust.com." } } } ], "tags": [ { "name": "Personal Data", "description": "APIs used to list links to personal-data items for an inventory and update advanced attributes on those associations.", "externalDocs": { "description": "OpenAPI 3.1.0 - Download Definition", "url": "https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json" } } ], "x-onetrust": { "spec-label": "OpenAPI 3.1.0", "links": [ "{'Data Mapping Automation Knowledge Base': 'https://my.onetrust.com/s/topic/0TO1Q000000ItRxWAK/data-mapping-automation'}" ] }, "x-readme": { "explorer-enabled": false, "proxy-enabled": false, "metrics-enabled": false }, "paths": { "/api/inventory/v2/data-categories": { "get": { "operationId": "getDataCategoriesByPartialNameUsingGET", "summary": "Get List of Data Categories", "description": "Use this API to retrieve a list of all existing Data Categories.", "tags": [ "Personal Data" ], "x-onetrust": { "spec-label": "https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json" }, "parameters": [ { "name": "filter", "in": "query", "description": "Optional filter string to search data categories by name", "required": false, "schema": { "type": "string" }, "example": "Financial" }, { "name": "page", "in": "query", "description": "Results page to be retrieved (0..N)", "schema": { "type": "integer", "format": "int32", "default": 0, "minimum": 0 }, "example": 0 }, { "name": "size", "in": "query", "description": "Number of records per page (1..50)", "schema": { "type": "integer", "format": "int32", "default": 20, "maximum": 50, "minimum": 1 }, "example": 20 }, { "name": "sort", "in": "query", "description": "Sorting criteria in the format: property(,asc|desc). Default sort order is ascending", "schema": { "type": "string", "enum": [ "name,asc", "name,desc", "createdDate,asc", "createdDate,desc" ] }, "example": "name,asc" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/OneTrustResponseListDataCategoryResponse" }, { "$ref": "#/components/schemas/DataCategoryResponse" } ] } } } }, "400": { "description": "Bad Request" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "429": { "description": "Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).", "headers": { "Retry-After": { "schema": { "description": "The number of seconds after which requests will be allowed again.", "format": "int32" } }, "ot-period": { "schema": { "description": "The unit of time for which the rate limit applies", "enum": [ "HOUR", "MINUTE" ] } }, "ot-ratelimit-event-id": { "schema": { "description": "The unique identifier for the rate-limiting event.", "format": "uuid" } }, "ot-request-made": { "schema": { "description": "The number of requests made within the specified period.", "format": "int32" } }, "ot-requests-allowed": { "schema": { "description": "The number of requests allowed within the specified period.", "format": "int32" } } } }, "500": { "description": "Internal Server Error" } }, "security": [ { "OAUTH2": [ "INTEGRATION" ] }, { "OAUTH2": [ "INVENTORY", "INVENTORY_READ", "INVENTORY_WRITE" ] } ] } } }, "components": { "schemas": { "OneTrustMetadata": { "type": "object", "properties": { "page": { "$ref": "#/components/schemas/OneTrustPage" } } }, "OneTrustPage": { "type": "object", "properties": { "first": { "type": "boolean" }, "last": { "type": "boolean" }, "number": { "type": "integer", "format": "int64" }, "size": { "type": "integer", "format": "int64" }, "totalElements": { "type": "integer", "format": "int64" }, "totalPages": { "type": "integer", "format": "int64" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/OneTrustSort" } } } }, "OneTrustSort": { "type": "object", "properties": { "direction": { "type": "string", "enum": [ "ASC", "DESC" ] }, "property": { "type": "string" } } }, "DataCategoryResponse": { "type": "object", "properties": { "id": { "description": "Unique identifier of the entity", "type": "string", "format": "uuid", "example": "43fd3a8d-3f6b-464e-bf43-3f0c6c592442" }, "name": { "description": "Name of the entity", "type": "string", "example": "Financial Data" }, "nameKey": { "description": "Translation key for the entity name", "type": "string", "example": "financial_data_name" }, "description": { "description": "Description of the entity", "type": "string", "example": "Contains financial information of customers" }, "descriptionKey": { "description": "Translation key for the entity description", "type": "string", "example": "financial_data_description" }, "source": { "description": "Source of the data category", "type": "string", "example": "SYSTEM", "enum": [ "SYSTEM", "USER", "IMPORTED" ] } }, "required": [ "id", "name", "nameKey" ] }, "OneTrustResponseListDataCategoryResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DataCategoryResponse" } }, "errors": { "type": "array", "items": { "type": "object" } }, "meta": { "$ref": "#/components/schemas/OneTrustMetadata" } } } }, "securitySchemes": { "OAUTH2": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://{hostname}/api/access/v1/oauth/token", "scopes": { "INVENTORY": "Inventory Scope gives the user access to read/write operations", "INVENTORY_READ": "Inventory Read Scope gives the user read-only access", "INVENTORY_WRITE": "Inventory Write Scope gives the user write access" } } } } } } } ``` # Sibling pages * [Create Data Category](https://developer.onetrust.com/onetrust/reference/createdatacategoryusingpost.md) * [Delete Data Category](https://developer.onetrust.com/onetrust/reference/deletedatacategoryusingdelete.md) * [Get Data Category](https://developer.onetrust.com/onetrust/reference/getdatacategoryusingget.md) * [Create Data Classification](https://developer.onetrust.com/onetrust/reference/createdataclassificationusingpost.md) * [Delete Data Classification](https://developer.onetrust.com/onetrust/reference/deletedataclassificationusingdelete.md) * [Get Data Classification](https://developer.onetrust.com/onetrust/reference/getdataclassificationusingget.md) * [Create Data Element](https://developer.onetrust.com/onetrust/reference/createdataelementusingpost.md) * [Get Data Element](https://developer.onetrust.com/onetrust/reference/getdataelementusingget.md) * [Delete Data Element](https://developer.onetrust.com/onetrust/reference/deletedataelementusingdelete.md) * [Get List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectsbypartialnameusingget.md) * [Create Data Subject](https://developer.onetrust.com/onetrust/reference/createdatasubjectusingpost.md) * [Get Data Subject](https://developer.onetrust.com/onetrust/reference/getdatasubjectusingget.md) * [Delete Data Subject](https://developer.onetrust.com/onetrust/reference/deletedatasubjectusingdelete.md)