The /events datapump API will retrieve messages from the datapump queue.
The datapump queue collects all messages from the user's account and all subaccounts. (Subaccounts with the 'enterprise' property set equal to true are excluded.) The datapump queue is unique to each user, meaning that a given account could have a separate datapump queue for each user in the account. The queue is activated the first time the /events API is called. After activation, any new messages received from devices in the account and subaccounts will be added to the queue. The oldest messages in the datapump queue are returned first, and once a message is read from the queue, it will be automatically removed from the datapump queue.
If the datapump queue is not requested in a 48-hour period, the datapump queue will automatically be disabled and will need to be reactivated by calling the GET /events API again.
Messages that are read and removed from the datapump queue will continue to be available later with any of the Results Services APIs. Additionally, if a datapump queue becomes inactive and automatically shuts down, any messages from devices will continue to be available with the Results Services APIs.