Runs examples for real against your account. Test keys only; kept in this tab, never stored on our side. Get a key
ZapSMTP / Docs / Received emails

List conversations

GET/v1/threads

List conversations (threads with at least one received email), the most recently active first: a helpdesk inbox.

Requires a full-access key.

Served from a per-conversation summary kept up to date as emails arrive: a page costs the same however much email you have.

A conversation you started (your first email) is counted once the customer answers it.

Query parameters

limitinteger
1-100; out-of-range falls back to 20. Default 20.
beforestring
Cursor: the last_message_at of the last conversation you have (RFC 3339). Limits: 422 invalid_parameter otherwise.
before_idstring
With before: the id of the last conversation you have, so conversations active at the same instant are neither skipped nor repeated.
awaiting_replyboolean
true: only conversations whose last human email came in.
unreadboolean
true: only conversations with an email received after their read mark.
participantstring
Only conversations this address took part in (case-insensitive).

Errors

restricted_api_keyHTTP 403
invalid_parameterHTTP 422
before must be an RFC 3339 time
GET/v1/threads
curl 'https://zapsmtp.xyz/v1/threads?awaiting_reply=true' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "thread",
      "id": "3f1c9a52-6b0e-5d4f-8a71-2c9e0b4d6f13",
      "subject": "Where is my order?",
      "participants": [
        "jane@example.org",
        "support@acme.com"
      ],
      "message_count": 3,
      "inbound_count": 2,
      "outbound_count": 1,
      "has_attachments": false,
      "first_message_at": "2026-10-21T15:10:02.904Z",
      "last_message_at": "2026-10-21T16:02:13.540Z",
      "last_inbound_at": "2026-10-21T16:02:13.540Z",
      "last_message": {
        "id": "019a1f52-0c1d-7f2e-8a3b-4c5d6e7f8091",
        "direction": "inbound",
        "from": "jane@example.org",
        "subject": "Re: Where is my order?"
      },
      "awaiting_reply": true,
      "unread": true,
      "read_at": null,
      "metadata": {
        "ticket": "T-1042"
      }
    }
  ]
}