List attachments for a received email | Resend API (unofficial showcase)

4 parameters

email_idstringrequired

The UUID of the received email whose attachments to list.

limitintegeroptional

The maximum number of attachments to return.

afterstringoptional

A UUID pagination cursor; returns attachments after the specified attachment. Cannot be used with `before`.

beforestringoptional

A UUID pagination cursor; returns attachments before the specified attachment. Cannot be used with `after`.

1 status code

200Returns an attachment list with attachment details, a `has_more` indicator, and the response object type.

objectstringoptional

Type of the response object.

has_morebooleanoptional

Indicates if there are more results available.

dataarray<object>optional

Array containing attachment information.

Error handling

The email_id path parameter must be a valid UUID identifying a received email. The after and before query parameters must be valid UUIDs and cannot be used together.

import { Client } from "@octridev/resend";

const client = new Client({
  baseUrl: "https://api.resend.com",
  auth: { bearer: process.env.API_TOKEN },
});

const result = await client.attachments.list({
  emailId: "9b2f1c10-7a3e-4d54-8c2a-1f6b9e0d4a21",
  limit: 20,
  after: "example",
  before: "example",
});

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440000",
      "filename": "document.pdf",
      "content_type": "application/pdf",
      "content_id": "img001",
      "content_disposition": "attachment",
      "download_url": "https://cloudfront.example.com/path?Signature=...",
      "expires_at": "2024-10-27T18:30:00.000Z",
      "size": 2048
    }
  ]
}

Request

Response

Errors