Retrieve IT System Changes Events

Overview Endpoint Reference Responses

Overview

The GET /api/hub/external-integration/it-systems/integration-events endpoint returns a paginated list of IT System change events since a specified date. Results can be filtered by event type and sorted by any supported field.

What you can do

✓Retrieve all IT System change events since a given date and time

✓Filter results by event type to narrow down the changes of interest

✓Control page size, page number, and sort order via query parameters

Prerequisites

✓A valid OAuth 2.0 bearer token

Endpoint Reference

Method

GET

Content-Type

application/json

URL

api/hub/external-integration/it-systems/integration-events

Query Parameters

Required JSON Parameters

Name	Value	Description
`eventType`	Enum	The type of change event to filter by. See the Appendix for accepted values.
`since`	Date	The start date and time for the change event query. Format: `yyyy-MM-dd'T'HH:mm:ss`. Example: `2024-01-01T23:30:00`
`page`	Integer	The results page to retrieve (0…N).
`size`	Integer	Number of records per page.
`sort`	asc \| desc	Sorting criteria in the format: `property,asc\|desc`. Multiple sort criteria are supported.

Sample curl Request

curl -X GET \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <Auth Token>' \
  'api/hub/it-systems/integration-events?since=2025-01-01T23%3A30%3A00&eventType=DATA_TRANSFER_RISK_CHANGED&page=0&size=20'

Responses

Success Response

Code: 200 OK

{
  "content": [
    {
      "entityId": "string",
      "recordType": "string",
      "eventType": "string",
      "oldValue": "string",
      "newValue": "string",
      "name": "string",
      "externalId": "string",
      "externalDataSource": "string",
      "created": "date",
      "action": "string",
      "field": "string",
      "reference": "string"
    }
  ],
  "last": true,
  "totalElements": 0,
  "totalPages": 0,
  "first": true,
  "size": 20,
  "number": 0,
  "sort": [
    {
      "direction": "ASC",
      "property": "created"
    }
  ],
  "numberOfElements": 0,
  "empty": false
}

Error Responses

Code: 400 Bad Request

Code: 401 Unauthorized

Code: 403 Forbidden

Code: 404 Not Found

TrustArc · Hub API — GET /api/hub/external-integration/it-systems/integration-events · support.trustarc.com

Search

Retrieve IT System Changes Events