To get the audit history of multiple assets, send a GET request using the audit API. Use the request URL parameters to specify the external or internal IDs of up to five assets and the details of the audit history that you want to view.
To get the audit history of multiple assets, submit a request with the following method and endpoint:
Method
Endpoint
GET
<baseApiUrl>/data360/audit/v1/assets/events
The <baseApiUrl> differs for each pod. For more information about the base API URL, see Send Requests.
Request parameters
In the request URL parameters, specify the internal or external IDs of up to five assets or specify the asset type to view the audit history. You can additionally specify the pagination and sorting parameters along with the other audit history details that you want the request to return.
Use the following parameters in the request URL:
Parameter
Description
offset
Specify a numeric value to set an offset for pagination. The default value is zero.
limit
Specify a numeric value between 1 to 100 for the number of records that you want to view on the page. The default value is 100.
filters
Specify the fields and values of the audit events that you want the API to use to filter the results. The request returns the audit events based on the fields that you apply as filters. Use the following format to apply filters:
field name:operator:(field value)
You can apply filters on one or more field names from the following list:
- assetId or assetExternalId. Specify the internal or external IDs of assets to view their audit history. You can specify up to five IDs separated by commas. For example, enter the following: assetExternalId:IN:(50K_BT_CDGC_34,CDGC_BT_4235)
- assetTypes. Specify the type of asset to view its audit history. Use this filter option only if you haven't specified the external or internal ID of the asset. For example, enter the following: assetTypes:IN:(com.infa.ccgf.models.governance.BusinessTerm)
- timestamp. Specify the date and time on which the asset was last updated. To specify the time range, use the following operators:
- GE. Greater than equal to
- LE. Less than equal to
For example, enter the following: timestamp:GE:(2024-01-29T18:21:14.564Z).
- eventType. Specify the events that include any changes to the asset, relationships, or stakeholders. For example, enter the following: eventType:IN:(Stakeholder,Relationship).
- action. Specify the actions that are performed on the asset to view the associated audit events. For example, enter the following: action:IN:(UPDATE).
- changedAttributes. Specify the changed attribute of the asset. For example, enter the following: changedAttributes:IN:(com.infa.odin.models.file.path,core.resourceType,core.reference,core.name,core.assetLifecycle,core.sourceModifiedOn).
- modifiedBy. Specify the ID of the user who has performed any action on the asset. For example, enter the following: modifiedBy:IN:datastewards_org.
sort
Sort the order of the events of the audit history by timestamps, event type, action, or the user ID who modified the asset. By default, the audit history of each asset is sorted in the descending order of the time of its events.
For example, you can enter timestamp:ASC to sort the events of the audit history of assets in the ascending order of the time of their events.
Example request
Get the audit history of business terms
The following example shows the GET request to get the audit history of business terms based on the asset type specified in the filter parameter. The response returns audit events that are generated after the specified date and time. The response displays a maximum of 100 records per page.
GET https://idmc-api.dm-us.informaticacloud.com/data360/audit/v1/assets/events?offset=0&limit=100&filter=timestamp:GE:(2025-05-01T18:21:14.564Z)&filter=assetTypes:IN:(com.infa.ccgf.models.governance.BusinessTerm)
Get the audit history of assets using the external ID
The following example shows the GET request to get the audit history of two assets based on the external IDs specified in the filter parameter. The response returns audit events that are generated before the specified date and time. The response displays a maximum of 100 records per page.
GET https://idmc-api.dm-us.informaticacloud.com/data360/audit/v1/assets/events?offset=0&limit=100&filter=assetExternalId:IN:(50K_BT_CDGC_34,CDGC_BT_4235)&filter=timestamp:LE:(2025-05-01T18:21:14.564Z)