List attachments
Lists the attachments on a message with their sizes and content types.
GET
/v1/messages/:id/attachments
Permission
The key must be granted mail.messages.read
A key without it gets 403 insufficient_scope, with the missing permission named in details.
Path parameters
| Field | Type | Description |
|---|---|---|
id required |
string | The message whose parts to list. |
Request
curl https://api.veruapis.com/v1/messages/:id/attachments \
-H "Authorization: Bearer vak_live_..."Response
| Field | Type | Description |
|---|---|---|
part_id |
string | Pass this as :part to download the bytes. |
filename |
string | |
content_type |
string | |
size |
integer | Bytes after decoding, not the encoded length on the wire. |
inline |
boolean | True for an image the HTML body refers to rather than a file attached to it. |
{
"data": { ... },
"meta": { "request_id": "req_01j8z9...", "timestamp": "2026-09-02T10:00:00Z" }
}A worked example for this endpoint has not been written yet.
Errors
Every failure uses the same shape, with a stable string code you can branch on. See the error reference.
Related
- POST Create a draft
- POST Create a mail filter
- POST Create a mail folder
- DELETE Delete a draft
- DELETE Delete a mail filter
- DELETE Delete a mail folder
- DELETE Delete a message
- GET Download an attachment
- GET Get a message
- GET Get display preferences
- GET List drafts
- GET List mail filters
- GET List mail folders
- GET List messages
- POST Move messages
- PUT Replace a draft
- POST Send an email
- POST Change flags and labels
- PATCH Rename a mail folder
- PATCH Update display preferences