lumail.emails.list

SDK 2.1.0 · API v2 · GET /api/v2/emails

MethodGET

/api/v2/emails

Request Examples

import { Lumail } from "lumail";

const lumail = new Lumail({ apiKey: process.env.LUMAIL_API_KEY });
const { data, error } = await lumail.emails.list({ limit: 20 });
if (error) {
  throw error;
}

for (const email of data.data) {
  console.log(email.id, email.last_event);
}

if (data.has_more) {
  const next = await lumail.emails.list({
    limit: 20,
    after: data.data.at(-1)?.id,
  });
  console.log(next.data?.data.length);
}

Response Examples

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "eml_abc123def456",
      "message_id": "0100018f3c2a1b2c-d4e5f6a7-89ab-cdef-0123-456789abcdef-000000",
      "to": ["[email protected]"],
      "from": "[email protected]",
      "created_at": "2026-09-05T10:30:00.000Z",
      "subject": "Welcome",
      "last_event": "delivered"
    }
  ]
}

[email protected] · lumail.emails

emails.list(params?: { limit?: number; after?: string; before?: string }): Promise<LumailResult<ListEmailsResponse>>

Newest first. Paginate with after or before email ids. Campaign sends and test emails are excluded.

Query Parameters

Pass after or before, not both. The cursor must be an email id in this organization.

Name	Type	Description
`limit`	number	Page size. Default `20`. Min `1`, max `100`.
`after`	string	Return emails older than this id (next page, walking backward in time).
`before`	string	Return emails newer than this id.

Response Fields

Field	Type	Description
`object`	`"list"`	Discriminator. Always `list`.
`has_more`	boolean	`true` when another page exists in the same direction.
`data`	`EmailObject[]`	Email rows, newest first. Same fields as `emails.get` except `object`, `html`, `text`, and `tags`.

data is { object, data, has_more }. Failures return { data: null, error: { name, message, statusCode } }.

Previouslumail.emails.get Nextlumail.emails.verify