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 received emails

GET/v1/emails/receiving

List received (inbound) emails, newest first.

Requires a full-access key.

action is default, webhook, store, reject or spam_reject. in_reply_to_email_id appears only when the message replies to an email you sent through ZapSMTP.

Query parameters

limitinteger
1-100; out-of-range falls back to 20. Default 20.
beforestring
Cursor: an email id or RFC 3339 time; returns messages received before it. An email id gives an exact page boundary. Limits: 422 invalid_parameter "before must be an email id or RFC 3339 time"
afterstring
Email id or RFC 3339 time. Limits: 422 invalid_parameter "after must be an email id or RFC 3339 time"
qstring
Case-insensitive substring of sender, recipient or subject, or an exact id.
statusstring
One of received, rejected.
domainstring
Inbound domain name (exact).
thread_idstring (UUID)
Only emails of this conversation (see GET /threads/{id}).
automatedstring
false: only emails a person wrote; true: only automated ones; or one type: bounce, out_of_office, auto_reply, auto_generated, bulk. Limits: 422 invalid_parameter for other values.

Errors

restricted_api_keyHTTP 403
invalid_parameterHTTP 422
inbound_not_configuredHTTP 503
inbound email is not enabled on this deployment
GET/v1/emails/receiving
curl 'https://zapsmtp.xyz/v1/emails/receiving?limit=10' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "email",
      "id": "019a1f30-1d4e-7a6b-8c2d-3e4f5a6b7c8d",
      "from": "jane@example.org",
      "from_name": "Jane Doe",
      "to": [
        "support@acme.com"
      ],
      "cc": [],
      "bcc": [],
      "reply_to": [],
      "received_for": [
        "support+1234@acme.com"
      ],
      "subject": "Re: Ticket #1234",
      "message_id": "<CAF=abc123@mail.example.org>",
      "created_at": "2026-10-21T15:10:02.904Z",
      "attachments": [
        {
          "id": "5b0f8f7e-2a1c-5d3e-9f4a-6b7c8d9e0f1a",
          "filename": "screenshot.png",
          "content_type": "image/png",
          "content_disposition": "attachment",
          "content_id": null,
          "size": 48213
        }
      ],
      "status": "received",
      "action": "webhook",
      "is_spam": false,
      "spam_score": 1.2,
      "size": 61877,
      "in_reply_to_email_id": "019a1f2e-7c3b-7d41-9a52-0c4b8e6f1a23"
    }
  ]
}