Gets the send status for a message. Because this route is rate-limited, use it for infrequent verification of a messageKey. To collect send status at scale, subscribe to transactional send events using the Event Notification Service.
|messageKey||string||Required||Unique identifier to track message send status. Can be up to 100 characters, and there are no restricted characters. You must provide it in singleton requests using the recipient attribute. To provide it in batch requests, use the recipients array attribute. If you don’t provide the message key for recipients, it’s generated in the response.|
|200||Request is accepted. Review example response.|
|requestId||string||The unique identifier of this request.|
|eventCategoryType||string||TransactionalSendEvents event type. EmailSent indicates that the email was sent to the email provider. EmailNotSent indicates that the email was not sent and includes the reason. EmailQueued indicates that the email has not yet been processed for sending.|
|timestamp||string||Time the event occured in Central Standard Time (no daylight savings)|
|compositeId||string||Marketing Cloud-specific processing identifier that can be referenced for support.|
|messageKey||string||Unique identifier to track message send status.|
|contactKey||string||Unique identifier for a subscriber in Marketing Cloud.|
|to||string||Channel address of the recipient. For email, it’s the recipient's email address.|
Example Response: Sent Status
The message is sent to the outbound mail service for delivery.
Example Response: Queued Status
The message is queued for processing and assigned a sent or notSent status after processing. The message remains in EmailQueued status when the definitionKey is inactive.
Example Response: NotSent Status
The message isn’t sent because of a processing error described in the info object.
|200 OK||Success. Review example responses.|
|400 Bad Request||Invalid request|
|401 Unauthorized||Failed to pass authorization.|
|500 Server Error||Internal error|