Amazon Simple Email Service
API Reference (API Version 2010-12-01)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


Recipient-related information to include in the Delivery Status Notification (DSN) when an email that Amazon SES receives on your behalf bounces.

For information about receiving email through Amazon SES, see the Amazon SES Developer Guide.



The action performed by the reporting mail transfer agent (MTA) as a result of its attempt to deliver the message to the recipient address. This is required by RFC 3464.

Type: String

Valid Values: failed | delayed | delivered | relayed | expanded

Required: Yes


An extended explanation of what went wrong; this is usually an SMTP response. See RFC 3463 for the correct formatting of this parameter.

Type: String

Required: No


Additional X-headers to include in the DSN.

Type: Array of ExtensionField objects

Required: No


The email address that the message was ultimately delivered to. This corresponds to the Final-Recipient in the DSN. If not specified, FinalRecipient will be set to the Recipient specified in the BouncedRecipientInfo structure. Either FinalRecipient or the recipient in BouncedRecipientInfo must be a recipient of the original bounced message.


Do not prepend the FinalRecipient email address with rfc 822;, as described in RFC 3798.

Type: String

Required: No


The time the final delivery attempt was made, in RFC 822 date-time format.

Type: Timestamp

Required: No


The MTA to which the remote MTA attempted to deliver the message, formatted as specified in RFC 3464 (mta-name-type; mta-name). This parameter typically applies only to propagating synchronous bounces.

Type: String

Required: No


The status code that indicates what went wrong. This is required by RFC 3464.

Type: String

Required: Yes

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: