V1_Entities_SpamTest

V1_Entities_SpamTest model

  • account
    Type: string
    required

    Minimal snapshot of the MailReach account that sent the test (ID, email, first/last name, score, detected provider). Returned on GET /:public_id.

  • analysis_results
    Type: string
    required

    Content analysis of the test email: spam words, link health, attachment count, HTML/image ratios, etc. Empty until completed.

  • autofix_triggered
    Type: boolean
    required

    True when an auto-fix task was triggered for this test. Query POST /v1/spamtest_auto_fix_tasks/lookup with { items: [{ test_public_id, from_email, btob_score, automated, test_type }] } to batch-fetch the autofix task records and a can_run_autofix flag per test.

  • automated
    Type: boolean
    required

    True if the test was launched by an automated test schedule.

  • automated_test_id
    Type: integerFormat: int32
    required

    ID of the automated test that launched this run, if any.

  • blacklist_links
    Type: array of string
    required

    DNSBL entries the links inside the test email appeared on at the time of the test.

  • blacklist_sending_ip
    Type: array of string
    required

    DNSBL entries the sending IP appeared on at the time of the test.

  • btob_score
    Type: numberFormat: float
    required

    Score computed on B2B seedlist mailboxes (Google Workspace / Office 365).

  • btoc_score
    Type: numberFormat: float
    required

    Score computed on B2C seedlist mailboxes (Gmail, Hotmail, Outlook.com, Yahoo).

  • completed
    Type: boolean
    required

    True once MailReach has finished processing the inbound copies and computed the scores.

  • created_at
    Type: stringFormat: date-time
    required

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • domain
    Type: string
    required

    DNS/authentication snapshot for the sending domain (SPF, DKIM, DMARC, MX records). Populated on GET /:public_id once the test completes.

  • final_score
    Type: numberFormat: float
    required

    Score selected by test_type (one of score, btob_score, btoc_score).

  • first_message_content
    Type: string
    required

    Parsed content and headers of the first test email MailReach received. null until at least one copy arrives. Includes subject, raw DKIM/SPF, authentication results, sending IP, attachments, and raw headers.

  • is_warming
    Type: boolean
    required
  • paid
    Type: boolean
    required

    Whether a spam check credit was spent on this test.

  • public_full_id
    Type: string
    required

    Globally unique tracking identifier. Include this string in the body of the test email so MailReach can match inbound copies back to the test.

  • public_id
    Type: string
    required
  • results
    Type: array of V1_Entities_SpamTestResult
    required

    Seedlist recipients to send the test email to. Populated on POST and GET /:public_id; absent from GET /.

    Properties: 7
  • score
    Type: numberFormat: float
    required

    Global deliverability score (0-10). null until completed.

  • seedlist
    Type: integerFormat: int32enum
    required

    Signed 32-bit integers (commonly used integer type).

    values
    1234
  • sending_provider
    Type: string
    required

    Provider detected from the sending IP. null until the test completes.

  • sending_reverse_dns_value
    Type: string
    required
  • spam
    Type: boolean
    required

    Set when the test email was flagged as spam content by MailReach.

  • summary
    Type: string
    required

    Counts of where the test emails landed, keyed by folder (INBOX, SPAM, etc.).

  • test_type
    Type: "all" or "btob" or "btoc"enum
    required

    Audience scope the score is computed against. null until set via POST /v1/spam_tests/{public_id}.

  • tld
    Type: string
    required

    Reputation snapshot for the sending domain TLD (e.g. com, co). Populated once the test completes.