Emails

List emails

Newest-first list of email summaries with cursor pagination.

GET/api/v1/emails

cURL

curl -X GET "https://inboundr.net/api/v1/emails" \
  -H "Authorization: Bearer $INBOUNDR_API_KEY"

Returns email summaries (no bodies), newest first, with cursor pagination.

directionstringquery

Filter by inbound or outbound.

tostringquery

Only emails addressed (To or Cc) to this address (case-insensitive).

threadIdstringquery

Only emails in this thread.

limitintegerquerydefault 50

Page size, 1–100.

cursorstringquery

nextCursor from a previous response.

Example response

200

{
  "data": [
    {
      "id": "em_abc123",
      "direction": "inbound",
      "threadId": "thr_xyz789",
      "messageId": "<CAEabc...@mail.gmail.com>",
      "fromAddress": "customer@example.com",
      "toAddresses": ["support@yourdomain.com"],
      "subject": "Can you help?",
      "spamVerdict": "PASS",
      "attachmentCount": 1,
      "receivedAt": "2026-07-20T10:30:00.000Z"
    }
  ],
  "nextCursor": "MjAyNi0w…"
}

nextCursorstring | null

Pass back as cursor for the next page; null when there are no more.