List Messages

GET {{baseUrl}}/api/v1/app/:app_id/msg?limit=<uint64>&iterator=<string>&channel=<string>&before=<dateTime>&after=<dateTime>&with_content=true&tag=<string>&event_types=<string>

List all of the application's messages.

The before and after parameters let you filter all items created before or after a certain date. These can be used alongside an iterator to paginate over results within a certain window.

Note that by default this endpoint is limited to retrieving 90 days' worth of data relative to now or, if an iterator is provided, 90 days before/after the time indicated by the iterator ID. If you require data beyond those time ranges, you will need to explicitly set the before or after parameter as appropriate.

Request Params

KeyDatatypeRequiredDescription
limitstringLimit the number of returned items
iteratorstringThe iterator returned from a prior invocation
channelstringFilter response based on the channel
beforestringOnly include items created before a certain date
afterstringOnly include items created after a certain date
with_contentbooleanWhen true message payloads are included in the response
tagstringFilter messages matching the provided tag
event_typesstringFilter response based on the event type

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;eventType&quot;:&quot;user.signup&quot;,&quot;id&quot;:&quot;msg_1srOrx2ZWZBpBUvZwXKQmoEYga2&quot;,&quot;payload&quot;:{&quot;email&quot;:&quot;test@example.com&quot;,&quot;type&quot;:&quot;user.created&quot;,&quot;username&quot;:&quot;test_user&quot;},&quot;timestamp&quot;:&quot;2016-01-01T14:13:53.016Z&quot;,&quot;eventId&quot;:&quot;unique-msg-identifier&quot;,&quot;channels&quot;:[&quot;project_123&quot;,&quot;group_2&quot;],&quot;tags&quot;:[&quot;project_1337&quot;]},{&quot;eventType&quot;:&quot;user.signup&quot;,&quot;id&quot;:&quot;msg_1srOrx2ZWZBpBUvZwXKQmoEYga2&quot;,&quot;payload&quot;:{&quot;email&quot;:&quot;test@example.com&quot;,&quot;type&quot;:&quot;user.created&quot;,&quot;username&quot;:&quot;test_user&quot;},&quot;timestamp&quot;:&quot;2014-08-19T01:33:10.195Z&quot;,&quot;eventId&quot;:&quot;unique-msg-identifier&quot;,&quot;channels&quot;:[&quot;project_123&quot;,&quot;group_2&quot;],&quot;tags&quot;:[&quot;project_1337&quot;]}],&quot;done&quot;:true,&quot;iterator&quot;:&quot;iterator&quot;,&quot;prevIterator&quot;:&quot;-iterator&quot;}