Skip to content

Order Management System REST API - Event Audit Controller

The event/audit/fromdate URL provides access to the events generated by OMS views.

GET /event/audit/fromdate

Retrieves the events between two timestamps in the event stream.

Requires the Audit feature permission.

ParameterExpectedDescription
fromOptionalAn ISO8601 date and time. The earliest timestamp to return (exclusive). If omitted, defaults to the beginning of time.
toOptionalAn ISO8601 date and time. The most recent timestamp to return (inclusive). If omitted, defaults to now.
countOptionalAn integer. The maximum number of records to return. If omitted, returns every record.
forOptionalThe SubscriptionType to return events for. Repeat for additional views. If omitted, supplies events for all views.
snapshotOptionalTrue to include starting snapshot events for the requested views. If omitted or false, no snapshot is supplied.
CodeStatusDescription
200SuccessContent is an array of EventMessage objects.
403FailureYou supplied invalid owner or account values.

In this example, we retrieve the first 100 Transaction events in the six-month period.

Terminal window
curl --oauth2-bearer $AccessToken http://oms.hub/event/audit/fromdate?from=20250101T000000Z&to=20250601T000000Z&count=100&for=Transactions