Skip to main content

SuppressionDetail

emailstringrequired
suppressedbooleanrequired
reasonstring

Possible values: [hard_bounce, soft_bounce, complaint, manual, unsubscribe, cleaned]

created_atstring<date-time>
bounce_history object[]
  • Array [
  • kindstringrequired

    A bounce carries the verdict fields; a complaint carries feedback_type.

    Possible values: [bounce, complaint]

    faultBounceFault

    Who the receiving system held responsible. recipient means the address itself cannot take mail, sender means the message or the sending reputation was refused, unknown means the reply did not say or the recipient's mail servers could not be reached. Failures on the Epostix side never appear as a bounce.

    Possible values: [recipient, sender, unknown]

    reasonBounceReason

    Why the message was refused. mailbox_unknown, mailbox_full, mailbox_disabled and domain_unroutable come with fault recipient; domain_unreachable and unclassified come with fault unknown; every other reason comes with fault sender. domain_unreachable means the recipient's mail servers could not be reached until delivery was given up; it suppresses the address progressively but does not count toward your bounce rate.

    Possible values: [mailbox_unknown, mailbox_full, mailbox_disabled, domain_unroutable, blocklist, reputation, rate_limited, policy, content, authentication, sender_address, domain_unreachable, unclassified]

    permanentboolean

    Whether the receiving system said retrying will not help.

    sourceBounceSource

    smtp is the receiving server's reply during delivery, ndr is a bounce message received after the server accepted the email, and suppression_list means the email was not sent because the address hard bounced on Epostix within the last 14 days. A suppression_list bounce counts toward your bounce rate and suppresses the address in your workspace.

    Possible values: [smtp, ndr, suppression_list]

    providerMailboxProvider

    Receiving mailbox provider. orange covers Orange and Wanadoo, free covers Free and Alice, sfr covers SFR, Neuf, Numericable and Club Internet, tonline covers T-Online and Magenta, seznam covers Seznam and email.cz, italiaonline covers Libero and Virgilio, and other covers every provider without its own value. New values may be added.

    Possible values: [gmail, microsoft, yahoo, apple, proton, zoho, gmx, wp, onet, interia, mailru, yandex, orange, free, sfr, laposte, tonline, seznam, italiaonline, comcast, other]

    smtp_codeinteger

    SMTP reply code. Absent when the receiving system gave none.

    enhanced_status_codestring

    RFC 3463 enhanced status code, for example 5.1.1.

    responsestring

    The receiving system's response text.

    feedback_typestring

    Feedback type of the complaint report, for example abuse. Present only on complaints.

    created_atstring<date-time>required
  • ]
  • SuppressionDetail
    {
    "email": "string",
    "suppressed": true,
    "reason": "hard_bounce",
    "created_at": "2024-07-29T15:51:28.071Z",
    "bounce_history": [
    {
    "kind": "bounce",
    "fault": "recipient",
    "reason": "mailbox_unknown",
    "permanent": true,
    "source": "smtp",
    "provider": "gmail",
    "smtp_code": 0,
    "enhanced_status_code": "string",
    "response": "string",
    "feedback_type": "string",
    "created_at": "2024-07-29T15:51:28.071Z"
    }
    ]
    }