Bounced Emails SES Logs
Returns emails to your institute's users that bounced, with the reason given by the receiving mail server, newest first. Use it to find learners whose email address is wrong or whose inbox is full.
GET
/ses/listlogs/bouncedBounced Emails SES Logs
curl --request GET \
--url 'https://<your-api-host>/nuSource/api/v1/ses/listlogs/bounced?start_time=1749686400&end_time=1752278400&page=1&per_page=2' \
--header 'APIKEY: <your-api-key>' \
--header 'ORGID: <your-org-id>'{
"code": 200,
"message": "Success",
"logs": [
{
"recipient": "testuser1@gmail.com",
"sender": "support@noreply.edupanion.com",
"subject": null,
"status": "bounced",
"timestamp": "2025-06-12 09:28:28",
"bounce_reason": "smtp; 552-5.2.2 The recipient's inbox is out of storage space and inactive. Please\n552-5.2.2 direct the recipient to\n552 5.2.2 https://support.google.com/mail/?p=OverQuotaPerm 6a1803df08f44-6fb35ad9569si12190026d6.59 - gsmtp"
},
{
"recipient": "eferf@gmail.com",
"sender": "support@noreply.edupanion.com",
"subject": null,
"status": "bounced",
"timestamp": "2025-06-12 09:16:46",
"bounce_reason": "Amazon SES did not send the message to this address because it is on the suppression list for your account. For more information about removing addresses from the suppression list, see the Amazon SES Developer Guide at https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-email-suppression-list.html"
}
],
"total": 18,
"page": 1,
"per_page": 2,
"pages": 9,
"page_context": {
"page": 1,
"per_page": 2
}
}Access: Any logged-in user.
Query parameters
Start of the period.
End of the period. At most 30 days after
start_time.pageinteger
Page number, starting at 1. Default 1.
per_pageinteger
Results per page. Default 20.
Response
codeinteger
Example:
200messagestring
Example:
Successlogsobject[]
Show child attributesHide child attributes
logs.recipientstring
Example:
testuser1@gmail.comlogs.senderstring
Example:
support@noreply.edupanion.comlogs.subjectnull
logs.bounce_reasonstring
The mail server's message, e.g. inbox full, or the address is on the suppression list
totalinteger
Example:
18pageinteger
Example:
1per_pageinteger
Example:
2pagesinteger
Example:
9page_contextobject
Show child attributesHide child attributes
page_context.pageinteger
Example:
1page_context.per_pageinteger
Example:
2Notes: Defaults to your institute. Errors: "End time must be after Start time" and "Date range cannot exceed 31 days" (the actual limit is 30 days). Rate limit: 30 requests per minute; going over locks you out for 30 minutes.