List all emails

List all email activity (sent, received, and scheduled) with comprehensive filtering options.

GET /api/e2/emails

TypeScript

TypeScript

import Inbound from "inboundemail";

const inbound = new Inbound();
const result = await inbound.emails.list({
  limit: 50,
  offset: 0
});

// Or iterate through all pages:
for await (const item of inbound.emails.listAll()) {
  // Process this item.
}

200

{
  "data": [
    {
      "id": "<string>",
      "type": "sent",
      "from": "<string>",
      "to": [
        "<string>"
      ],
      "subject": "<string>",
      "status": "<string>",
      "created_at": "<string>",
      "has_attachments": true,
      "message_id": "<string>",
      "from_name": "<string>",
      "envelope_recipient": "<string>",
      "envelope_recipients": [
        "<string>"
      ],
      "cc": [
        "<string>"
      ],
      "preview": "<string>",
      "sent_at": "<string>",
      "scheduled_at": "<string>",
      "attachment_count": 123,
      "is_read": true,
      "read_at": "<string>",
      "is_archived": true,
      "thread_id": "<string>",
      "spam": {
        "is_junk": true,
        "reason": "<string>"
      }
    }
  ],
  "pagination": {
    "limit": 123,
    "offset": 123,
    "total": 123,
    "has_more": true
  },
  "filters": {
    "type": "<string>",
    "status": "<string>",
    "time_range": "<string>",
    "search": "<string>",
    "domain": "<string>",
    "address": "<string>",
    "is_junk": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Your Inbound API key. Include it in the Authorization header as: Bearer

Query Parameters

type · enum<string>

Available options: all, sent, received, scheduled

status · enum<string>

Available options: all, delivered, pending, failed, bounced, scheduled, cancelled, paused, unread, read, archived

time_range · enum<string>

Available options: 1h, 24h, 7d, 30d, 90d, all

search · string

Search query to filter emails by subject, sender, or recipient. Case-insensitive partial match.

domain · string

Filter by domain. Accepts domain ID (e.g., 'dom_xxx') or domain name (e.g., 'example.com').

address · string

Filter by email address. Accepts address ID (e.g., 'addr_xxx') or raw email address (e.g., '[e-mail]').

is_junk · enum<string>

Available options: true, false

limit · string · default: 50

Maximum number of emails to return (1-100). Default is 50.

offset · string · default: 0

Number of emails to skip for pagination. Default is 0.

Response

200

application/json

Response for status 200

data · object[] · required

Array of email objects matching the query

Show child attributes

pagination · object · required

Pagination metadata

Show child attributes

filters · object · required

Applied filters for this query

Show child attributes