Sign inGet Started
Get started
Guides
API Reference
SDKs
CLI
Knowledge Base
Changelog

List a received email's attachments

GET
/v1/email/inbound-messages/{inbound_message_id}/attachments
bird email inbound-messages attachments <inbound-message-id>
Response200
{
  "data": [
    {
      "id": "rea_01krdgeqcxet5s7t44vh8rt9mg",
      "filename": "invoice.pdf",
      "content_type": "application/pdf",
      "size": 215432
    }
  ]
}

Returns metadata for each attachment on a received email:

  • The attachment_id.
  • The declared filename.
  • The MIME type.
  • The size.

The same manifest is embedded in Get a received email. Fetch an individual attachment's bytes with Get a received email's attachment.

Parameters

inbound_message_idstring

Received email identifier. Starts with rem_.

Response Payload

data
array of object
required

Metadata for every attachment on the message. Empty when the message had no attachments.

Show child attributes
data.id
string
required

Attachment ID, stable within the received message.

data.filename
nullable string
required

Filename from the attachment's Content-Disposition, or null when the sender did not name the part.

data.content_type
nullable string
required

MIME type parsed from the attachment part, or null when absent.

data.size
integer
required

Size of the attachment in bytes.

Related resources

Continue with the documentation, guides and examples for this topic.

Try the practice and get an implementation brief