Inbound Emails
Get Message
Retrieves a single inbound email message by its ID, including full text/HTML bodies, headers, attachments metadata, threading information, and verdicts.
GET
/
inbound
/
messages
/
{id}
curl --request GET \
--url https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234 \
--header 'Authorization: Bearer as_your-api-key'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b1234",
"providerMessageId": "abc123def456",
"messageId": "<[email protected]>",
"domainName": "support.example.com",
"from": {
"email": "[email protected]",
"name": "Jane Customer"
},
"to": [
{
"email": "[email protected]",
"name": null
}
],
"cc": [],
"bcc": [],
"replyTo": [],
"subject": "Question about my order",
"text": "Hi, I wanted to check on the status of order #4821.",
"html": "<p>Hi, I wanted to check on the status of order #4821.</p>",
"attachments": [
{
"attachmentId": "att_60d5ec49f1b2c72d9c8b9999",
"filename": "receipt.pdf",
"contentType": "application/pdf",
"size": 20480,
"index": 0
}
],
"headers": {
"from": "Jane Customer <[email protected]>",
"to": "[email protected]",
"subject": "Question about my order"
},
"spamVerdict": "PASS",
"virusVerdict": "PASS",
"spfVerdict": "PASS",
"dkimVerdict": "PASS",
"dmarcVerdict": "PASS",
"status": "PROCESSED",
"threadId": "60d5ec49f1b2c72d9c8b1234",
"inReplyTo": null,
"inReplyToEmailActivityId": null,
"inReplyToInboundEmailId": null,
"receivedAt": "2026-06-20T10:15:30.000Z"
}
}
This endpoint uses a standard project API key (
AS_ prefix). The message must belong to the project the key is scoped to.curl --request GET \
--url https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234 \
--header 'Authorization: Bearer as_your-api-key'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b1234",
"providerMessageId": "abc123def456",
"messageId": "<[email protected]>",
"domainName": "support.example.com",
"from": {
"email": "[email protected]",
"name": "Jane Customer"
},
"to": [
{
"email": "[email protected]",
"name": null
}
],
"cc": [],
"bcc": [],
"replyTo": [],
"subject": "Question about my order",
"text": "Hi, I wanted to check on the status of order #4821.",
"html": "<p>Hi, I wanted to check on the status of order #4821.</p>",
"attachments": [
{
"attachmentId": "att_60d5ec49f1b2c72d9c8b9999",
"filename": "receipt.pdf",
"contentType": "application/pdf",
"size": 20480,
"index": 0
}
],
"headers": {
"from": "Jane Customer <[email protected]>",
"to": "[email protected]",
"subject": "Question about my order"
},
"spamVerdict": "PASS",
"virusVerdict": "PASS",
"spfVerdict": "PASS",
"dkimVerdict": "PASS",
"dmarcVerdict": "PASS",
"status": "PROCESSED",
"threadId": "60d5ec49f1b2c72d9c8b1234",
"inReplyTo": null,
"inReplyToEmailActivityId": null,
"inReplyToInboundEmailId": null,
"receivedAt": "2026-06-20T10:15:30.000Z"
}
}
Authorizations
Project API key header of the form Bearer
as_<key>. You can also pass the key via the x-api-key header.Path Parameters
The unique identifier of the inbound message. The message must belong to the authenticated project.Example:
"60d5ec49f1b2c72d9c8b1234"Response
Message retrieved successfullyIndicates if the request was successfulExample:
trueThe full inbound message object
Show child attributes
Show child attributes
Unique inbound message identifier
Provider (SES) message ID — the idempotency key for the message
RFC 5322
Message-ID header from the original emailDomain the message was received on
Sender address (
email, name)Recipient addresses (
email, name)CC addresses (
email, name)BCC addresses (
email, name)Reply-To addresses (
email, name)Message subject
Plain-text body (truncated; raw MIME in storage is the source of truth)
HTML body (truncated; raw MIME in storage is the source of truth)
Attachment metadata. Each entry includes
attachmentId, filename, contentType, size, and a zero-based index used to download the attachment.Map of raw email headers (header name → string value)
Spam verdict (e.g.
PASS, FAIL)Virus verdict
SPF verdict
DKIM verdict
DMARC verdict
Message status:
PROCESSED, PROCESSING, FAILED, BLOCKED_UNVERIFIED, or BLOCKED_UNROUTEDIdentifier of the conversation thread this message belongs to
Raw
In-Reply-To header value from the original emailID of the outbound email this message is a reply to, if matched
ID of a previously received inbound message this message is a reply to, if matched
Timestamp the message was received (ISO 8601)
Error Responses
Returned when the
id parameter is not valid.{
"success": false,
"error": {
"message": "Invalid value",
}
}
Returned when the message does not exist or does not belong to the authenticated project.
{
"success": false,
"error": {
"message": "Inbound email not found"
}
}
⌘I
curl --request GET \
--url https://api.autosend.com/v1/inbound/messages/60d5ec49f1b2c72d9c8b1234 \
--header 'Authorization: Bearer as_your-api-key'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b1234",
"providerMessageId": "abc123def456",
"messageId": "<[email protected]>",
"domainName": "support.example.com",
"from": {
"email": "[email protected]",
"name": "Jane Customer"
},
"to": [
{
"email": "[email protected]",
"name": null
}
],
"cc": [],
"bcc": [],
"replyTo": [],
"subject": "Question about my order",
"text": "Hi, I wanted to check on the status of order #4821.",
"html": "<p>Hi, I wanted to check on the status of order #4821.</p>",
"attachments": [
{
"attachmentId": "att_60d5ec49f1b2c72d9c8b9999",
"filename": "receipt.pdf",
"contentType": "application/pdf",
"size": 20480,
"index": 0
}
],
"headers": {
"from": "Jane Customer <[email protected]>",
"to": "[email protected]",
"subject": "Question about my order"
},
"spamVerdict": "PASS",
"virusVerdict": "PASS",
"spfVerdict": "PASS",
"dkimVerdict": "PASS",
"dmarcVerdict": "PASS",
"status": "PROCESSED",
"threadId": "60d5ec49f1b2c72d9c8b1234",
"inReplyTo": null,
"inReplyToEmailActivityId": null,
"inReplyToInboundEmailId": null,
"receivedAt": "2026-06-20T10:15:30.000Z"
}
}