Getting the Most out of Courier Logs

During our August 19th Courier Live, Tony Nguyen from our engineering team joined me to talk about my favorite Courier feature, the logs. We presented a high level overview of the logs and dove into the details of each timeline event in the Courier Application. We then covered how you could retrieve the same information using the Messages API.

Check out the video below to watch us:

• Explain the basics of the Courier Logs
• Walk through the lifecycle of a notification
• Explore the notification statuses
• Use the Messages API to retrieve message events and history

Retrieving Log Details Programmatically

While Courier provides a great graphical experience for viewing their logs, sometimes you need to be able to grab that information as part of a backend process. This can be done using the Messages API.

Listing Messages

You can retrieve a pageable list of log messages using GET /messages.

curl --request GET \
  --url https://api.courier.com/messages \
  --header 'authorization: Bearer <AUTH_TOKEN>'

Fetching a single Message

Once you have a messageId, either from the call above or the response of a send call, you can use it to get more details using GET /messages/{message_id}.

curl --request GET \
  --url https://api.courier.com/messages/1-5f3d7aa7-e4b8f9ba9a4672ba5d46754c \
  --header 'authorization: Bearer <AUTH_TOKEN>'

Getting Message History

If you would like to retrieve the details provided in the log details timeline, you can use GET /messages/{message_id}/history.

curl --request GET \
  --url https://api.courier.com/messages/1-5f3d7aa7-e4b8f9ba9a4672ba5d46754c/history \
  --header 'authorization: Bearer <AUTH_TOKEN>'

You can learn more about the Courier API from the Courier API Reference Documentation.

Is there something you’d like to see us do using Courier? Let us know and it might be the subject of our next Courier Live. We stream a new Courier Live every Wednesday at noon Pacific. Follow us on Twitch to be notified when we go live.

-Aydrian