Get a received email
GET
/v1/email/inbound-messages/{inbound_message_id}
curl -X GET "https://us1.platform.bird.com/v1/email/inbound-messages/{inbound_message_id}" \
-H "Authorization: Bearer $TOKEN"Returns the parsed metadata for a received email. Fetch the body with /body and attachment bytes with /attachments/{attachment_id}.
Payload de resposta
id
string
obrigatório
Received message ID.
from
object
obrigatório
Sender address parsed from the message.
Mostrar atributos secundários
from.email
string
obrigatório
Email address.
from.name
string
Display name shown alongside the address in mail clients.
to
array of object
obrigatório
Recipients on the message's To header.
Mostrar atributos secundários
to.email
string
obrigatório
Email address.
to.name
string
Display name shown alongside the address in mail clients.
cc
array of object
obrigatório
Recipients on the message's Cc header.
Mostrar atributos secundários
cc.email
string
obrigatório
Email address.
cc.name
string
Display name shown alongside the address in mail clients.
subject
nullable string
obrigatório
Subject line as received, or null when the message had no subject.
message_id
nullable string
obrigatório
RFC 5322 Message-ID header from the sender, or null when the sender did not include one.
in_reply_to
nullable string
obrigatório
In-Reply-To header — the Message-ID this message replies to, or null when it is not a reply.
references
array of string
References header — the chain of Message-IDs in this conversation, oldest first. Absent when the message had no References header.
thread_id
nullable string
obrigatório
Conversation this message belongs to. Always null until threading is available.
spf_pass
nullable boolean
obrigatório
Whether SPF passed for the sender, parsed from the message's authentication results. Null when the result did not carry an SPF verdict.
dkim_pass
nullable boolean
obrigatório
Whether DKIM passed for the sender, parsed from the message's authentication results. Null when the result did not carry a DKIM verdict.
dmarc_pass
nullable boolean
obrigatório
Whether DMARC passed for the sender, parsed from the message's authentication results. Null when the result did not carry a DMARC verdict.
spam_score
nullable number
obrigatório
Spam score for the message. Always null at present; reserved for a future content-scoring capability.
attachments
array of object
obrigatório
Metadata for each attachment found on the message. Empty when the message had no attachments.
Mostrar atributos secundários
attachments.id
string
obrigatório
Attachment ID, stable within the received message.
attachments.filename
nullable string
obrigatório
Filename from the attachment's Content-Disposition, or null when the sender did not name the part.
attachments.content_type
nullable string
obrigatório
MIME type parsed from the attachment part, or null when absent.
attachments.size
integer
obrigatório
Size of the attachment in bytes.
received_at
string
obrigatório
When Bird received the message.