Docs home

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/bounced
Bounced 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_timeUnix timestamprequired
Start of the period.
end_timeUnix timestamprequired
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.
Response200application/json
codeinteger
Example: 200
messagestring
Example: Success
logsobject[]
Show child attributesHide child attributes
Example: testuser1@gmail.com
Example: support@noreply.edupanion.com
Always bounced
Example: bounced
UTC, YYYY-MM-DD HH:MM:SS
Example: 2025-06-12 09:28:28
The mail server's message, e.g. inbox full, or the address is on the suppression list
totalinteger
Example: 18
pageinteger
Example: 1
per_pageinteger
Example: 2
pagesinteger
Example: 9
Show child attributesHide child attributes
Example: 1
Example: 2

Notes: 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.

Updated yesterday

Ask AI