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

List simulator addresses

GET/v1/simulator

List the simulator addresses and the events each produces.

Requires a full-access key.

Errors

restricted_api_keyHTTP 403
GET/v1/simulator
curl 'https://zapsmtp.xyz/v1/simulator' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "domain": "simulator.zapsmtp.xyz",
  "note": "Simulator recipients never leave ZapSMTP, work with live and test keys, never touch your suppression list or reputation, and accept +labels (delivered+signup@…).",
  "scenarios": [
    {
      "address": "delivered@simulator.zapsmtp.xyz",
      "event": "email.delivered",
      "result": "250 accepted by the mailbox"
    },
    {
      "address": "bounced@simulator.zapsmtp.xyz",
      "event": "email.bounced",
      "result": "550 5.1.1 Permanent / MailboxDoesNotExist"
    },
    {
      "address": "full@simulator.zapsmtp.xyz",
      "event": "email.bounced",
      "result": "552 5.2.2 Permanent / MailboxFull"
    },
    {
      "address": "blocked@simulator.zapsmtp.xyz",
      "event": "email.bounced",
      "result": "554 5.7.1 Permanent / SpamBlocked"
    },
    {
      "address": "delayed@simulator.zapsmtp.xyz",
      "event": "email.delivery_delayed → email.delivered",
      "result": "451 on the first attempt, delivered ~20 s later"
    },
    {
      "address": "complained@simulator.zapsmtp.xyz",
      "event": "email.delivered → email.complained",
      "result": "delivered, then an ARF abuse complaint"
    },
    {
      "address": "suppressed@simulator.zapsmtp.xyz",
      "event": "email.suppressed",
      "result": "treated as on your suppression list; not sent"
    },
    {
      "address": "bounce+421+4.7.0+try-later@simulator.zapsmtp.xyz",
      "event": "email.delivery_delayed",
      "result": "any reply you need: bounce+<code>[+<x.y.z>][+<words-with-dashes>]"
    }
  ]
}