Skip to main content
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

​
status
string
Filter by message status — e.g. delivered, bounced, queued, complained.
​
direction
string
inbound or outbound.
​
q
string
Search recipient, sender, or subject.
​
limit
integer
Page size, 1–100.
​
cursor
string
The nextCursor from the previous response.

​
Headers

​
X-Drin-Product
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"

​
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.