Querying Data in the Event Repository

The Event REST APIs include event-query services that retrieve data from the Event Repository.

The Event REST APIs include the messaging and elements to return EDRs and notifications in the Event Repository and the Event database for subscriptions, groups, and users.
Note: The Event REST APIs are implemented in the RS Gateway and do not have a Java equivalent.

The Event REST APIs that retrieve data from the Event Repository include:

  • GET /eventstore/group/{SearchTerm:.+}
  • GET /eventstore/notification/EventId/{EventId:.*}
  • GET /eventstore/notification/group/{SearchTerm:.+}
  • GET /eventstore/notification/subscription/{SearchTerm:.+}
  • GET /eventstore/notification/user/{SearchTerm:.+}
  • GET /eventstore/query
  • GET /eventstore/query/EventId/{EventId:.*}
  • GET /eventstore/subscription/{SearchTerm:.+}
  • GET /eventstore/user/{SearchTerm:.+}
All Event REST APIs, except for the GET /eventstore/query API, search events from three data sources: the Activity database, the Event database, and the Event Repository. The GET /eventstore/query API queries only the Event Repository.
Note: If you include the searchInMemoryDatabase=false parameter, only events in the Event Repository are returned; recent events and aggregated events in progress are not returned.

The GET /eventstore/query service performs a query that retrieves EDRs from the Event Repository by event type (eventTypes) and event time range (eventTimeLowerBound and eventTimeUpperBound). The data in the retrieved EDRs can be processed to find specific information; for example, to find all subscribers that have been suspended in the past week or to find all offer cancelations that occurred today.

For more information about Event REST APIs, see the discussion about the Event REST APIs in MATRIXX Subscriber Management API.

For information about making REST calls, see MATRIXX Subscriber Management API.

For information about configuring the RS Gateway to connect to the Event Repository, see the discussion about configuring the RS Gateway in MATRIXX Web App Administration.