Retrieve Bounce Event Details

Retrieve the details of an email bounce event to understand why an email didn’t reach its target subscriber.

By minimizing the number of bounces for emails you send, you can improve your sender reputation. Maintaining a good reputation can help to reduce deliverability issues.

This sample SOAP envelope retrieves bounce events that occurred within a specific date range.

1<s:Envelope
2  xmlns:s="http://www.w3.org/2003/05/soap-envelope"
3  xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"
4  xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
5  <s:Header>
6    <a:Action s:mustUnderstand="1">Retrieve</a:Action>
7    <a:To s:mustUnderstand="1">https://YOUR_SUBDOMAIN.soap.marketingcloudapis.com/Service.asmx</a:To>
8    <fueloauth xmlns="http://exacttarget.com">YOUR_ACCESS_TOKEN</fueloauth>
9  </s:Header>
10  <s:Body
11    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
12    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
13    <RetrieveRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
14      <RetrieveRequest>
15        <ObjectType>BounceEvent</ObjectType>
16        <Properties>Client.ID</Properties>
17        <Properties>TriggeredSendDefinitionObjectID</Properties>
18        <Properties>SendID</Properties>
19        <Properties>SubscriberKey</Properties>
20        <Properties>EventDate</Properties>
21        <Properties>EventType</Properties>
22        <Properties>BatchID</Properties>
23        <Filter xsi:type="SimpleFilterPart">
24          <Property>EventDate</Property>
25          <SimpleOperator>between</SimpleOperator>
26          <DateValue>2025-06-30T03:00:00.000Z</DateValue>
27          <DateValue>2025-09-29T02:59:59.999Z</DateValue>
28        </Filter>
29      </RetrieveRequest>
30    </RetrieveRequestMsg>
31  </s:Body>
32</s:Envelope>

Retrieve Bounce Event Details

See Also