Skip to content

Order Management System REST API - Event Audit Controller

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

Retrieves the events between a timestamp and a position in the event stream.

Section titled “Retrieves the events between a timestamp and a position in the event stream.”

GET /event/audit/between

Retrieves the events between a timestamp and a position in the event stream for the requested views.

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.
to[<seq>]RequiredDescribes the ending position of a sequence (inclusive). Repeat for each feed involved in OMS.
countOptionalThe 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 updates after a timestamp:

Terminal window
curl --oauth2-bearer $AccessToken http://oms.hub/event/audit/toposition?from=20250101T000000Z&to[prodigy]=20&to[oms]=200&to[foundry]=10&count=100&for=Transactions