List emails

Page through your messages, newest first. Filter by delivery status, direction (inbound or outbound), or a free-text search over sender, recipient, and subject. GET /v1/emails Returns a cursor page of message summaries. Combine the filters below with limit and cursor; keep the filters constant across a walk.

Query parameters

string

Filter by message status — e.g. delivered, bounced, queued, complained.

string

inbound or outbound.

string

Search recipient, sender, or subject.

integer

Page size, 1–100.

string

The nextCursor from the previous response.

Headers

header

Scopes the listing to one project for account-wide keys (alias: X-Drin-Sender).

Request

curl "https://api.drin.run/v1/emails?status=bounced&limit=50" \
  -H "Authorization: Bearer $DRIN_API_KEY"

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

// One page
const page = await drin.emails.list({ status: "bounced", limit: 50 });

// Or walk every page
for await (const message of drin.emails.paginate({ direction: "inbound" })) {
  console.log(message.from, message.subject);
}

Response

200 OK — a page of message summaries plus a nextCursor. Each summary omits the body and event lifecycle; fetch those with GET /v1/emails/{id}.

200 OK

{
  "data": [
    {
      "id": "msg_01HZX9K3T2QF7P0M4N8B6C5D",
      "from": "onboarding@yourdomain.com",
      "to": ["you@example.com"],
      "subject": "Hello from Drin",
      "status": "delivered",
      "direction": "outbound",
      "createdAt": "2026-06-02T17:04:00Z"
    }
  ],
  "nextCursor": "eyJpZCI6Im1zZ18wMUhaVyJ9"
}

Reaching the end. When nextCursor is null, there are no more results. See Pagination for the full walk and the SDK’s auto-paginating iterator.

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

List emails

Query parameters

Headers

Request

Response

​Query parameters

​Headers

​Request

​Response

Query parameters

Headers

Request

Response