List Emails API
This API allows you to retrieve previously sent emails.
get
https://api.postman.gov.sg/v1
/transactional/email
List transactional emails
The response is a JSON object with the following fields:
has_more: a boolean indicating whether there are more emails to retrievedata: an array of JSON email objects. You can find an example of a single JSON email object here. We support excluding theparamsfield from the response object, see this section for more information.
You can specify the number of emails to return per page using the
limit query parameter. The default value is 10, the minimum value is 1, and the maximum value is 1000.You can specify the number of emails to skip using the
offset query parameter. The default value is 0.We currently support the following filters:
tag: return emails with the specified tag. This is a user-defined tag that is created when the email is sent. For more information, see this sectioncreated_at: return emails created within the specified time range; this roughly corresponds to the time when the API call to send the email was made.
For
created_at, the timestamp should be specified in valid ISO 8601 format. The list of supported operators are:gt: greater thangte: greater than or equal tolt: less thanlte: less than or equal to
The default sorting option is
created_at, descending.We currently support the following sorting options:
created_at: sort by the time when the email was created; this roughly corresponds to the time when the API call to send the email was madeupdated_at: sort by the time when the email was last updated
We support both ascending and descending order.
To specify the order, add the prefix
+ for ascending order and - for descending order. For example, +created_at will sort by created_at in ascending order, and -updated_at will sort by updated_at in descending order. If the prefix is omitted, descending order will be used.Depending on the email
body, the params field could be fairly large and unnecessary to users who are calling this API to retrieve the latest status.As such, we support an optional
exclude_params field that allows you to exclude the params field from the response. To do so, set exclude_params to true in the query parameters, i.e. GET /transactional/email?exclude_params=true. If exclude_params is not specified, the params field will be included in the response.Returns the first 10 emails sorted by
created_at in descending orderReturns the next 20 emails sorted by
created_at in descending orderReturns the first 10 emails with status
DELIVERED sorted by created_at in descending orderReturns the first 10 emails created after
2023-05-10T03:03:54.163Z sorted by created_at in descending order. Do note that if the timezone is not specified, it will be assumed to be UTC.Returns the first 10 emails created between
2023-05-03 and 2023-05-10 sorted by created_at in descending order.Returns the first 48 emails with status
DELIVERED created on or after 2022-11-01 sorted by created_at in ascending order.Last modified 4mo ago