ONonetrust
Inventory

Get Inventory by ID

Use this API to retrieve the details of a specific inventory.

get/api/inventory/v2/inventories/{schemaName}/{id}

Request

  • Base URL
    https://hostname
  • URL
    https://hostname/api/inventory/v2/inventories/{schemaName}/{id}
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://{hostname}/api/access/v1/oauth/token scopes: INVENTORY, INVENTORY_READ, INVENTORY_WRITE

Path parameters

schemaName'processing-activities' | 'vendors' | 'assets' | 'entities' required

The name property of the schema. The value can be obtained using the Get Schemas API.

idstring uuid required

The unique identifier of an inventory record. The value can be obtained using the List Inventories API.

Response

OK - Successfully retrieved inventory details.

OR
OR
OR

Example response

{
  "data": {
    "id": "96214230-ffbb-4870-b6c4-0f30c3bfec60",
    "canViewDetails": true,
    "name": "Vendor XYZ",
    "riskLevel": "HIGH",
    "riskScore": 8.5,
    "status": {
      "key": "active",
      "name": "Active"
    },
    "externalId": "EXT-12345",
    "createdDate": "2023-01-15T10:30:45.123Z",
    "updatedDate": "2023-02-20T14:15:30.456Z",
    "selectFields": {
      "data-residency": [
        {
          "key": "us",
          "value": "US"
        }
      ]
    },
    "textFields": {
      "description": "Sample description"
    },
    "number": 123,
    "isParent": true,
    "inheritFromMaster": true,
    "parentInventoryId": "96214230-ffbb-4870-b6c4-0f30c3bfec60",
    "masterRecord": "MASTER-001",
    "workflowStage": {
      "badgeColor": "#4CAF50"
    },
    "inherentRiskLevel": "MEDIUM",
    "inherentRiskScore": 6.5,
    "targetRiskLevel": "LOW",
    "targetRiskScore": 3,
    "totalHierarchyRiskLevel": "HIGH",
    "totalHierarchyRiskScore": 8,
    "totalHierarchyInherentRiskLevel": "MEDIUM",
    "totalHierarchyInherentRiskScore": 6,
    "totalHierarchyTargetRiskLevel": "LOW",
    "totalHierarchyTargetRiskScore": 3,
    "inventoryDeleteType": "SOFT",
    "deletedReason": "No longer required",
    "deletedBy": "ab0b11d9-8ba2-46f3-b845-2ca50bef4efc",
    "deletedDate": "2023-03-01T12:00:00.000Z",
    "isGlobalAttributeConfigurationEnabled": true,
    "sourceId": "c79fb1a9-9406-4e9b-bff7-c72e635ee82b",
    "integrationWorkflowId": "wf-123",
    "sourceType": "API_INTEGRATION",
    "reviewType": "ANNUAL",
    "detailsUri": "https://app.onetrust.com/inventory/details/vendors/c79fb1a9-9406-4e9b-bff7-c72e635ee82b",
    "redacted": [
      "field1",
      "field2"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.