List spam tests

​

Returns spam tests belonging to your project. Results are paginated (10 per page, page is zero-indexed) and can be sorted.

  • order_by — field to sort by. created_at (default) sorts by the test creation date; score sorts by the final score (the same value exposed as final_score on each item — btob_score for B2B tests, btoc_score for B2C, otherwise the raw score).
  • order — sort direction, asc or desc. Defaults to desc.
  • search — full-text query matched against the test subject and sender from.

Omit order_by/order to keep the default ordering: newest first (created_at desc).

Note: when search and order_by=score are combined, results are sorted by the raw score (the search index can only sort indexed fields), which differs from final_score only for btob/btoc tests. The non-search list always sorts by the exact final_score.

Query Parameters
  • page
    Type: integerFormat: int32
    required

    Zero-indexed page number. Each page contains up to 10 spam tests.

  • automated_test_id
    Type: integerFormat: int32

    Only return spam tests associated with the given automated test.

  • search
    Type: string

    Filter spam tests by subject or sender email.

  • order_by
    Type: stringenum

    Field to sort by. created_at (default) or score (the final score). Omit for newest-first.

    values
    • created_at
    • score
  • order
    Type: stringenum

    Sort direction, asc or desc. Defaults to desc.

    values
    • asc
    • desc
Responses
  • application/json
  • application/json
Request Example for get/v1/spam_tests
curl 'http://api.mailreach.co/api/v1/spam_tests?page=0&automated_test_id=1234&search=welcome%20email&order_by=score&order=desc' \
  --header 'X-Api-Key: YOUR_SECRET_TOKEN'

[
  {
    "public_full_id": "mlrch-c7a47e3e94e98b6fd78d60a",
    "public_id": "c7a47e3e94e98b6fd78d60a",
    "results": [
      {
        "id": 6,
        "email": "siobhan@reachsecret.com",
        "desc": "Google Workspace with smart features",
        "first_name": "Siobhan",
        "provider": "gmail",
        "received_in": "INBOX",
        "raw_headers": "string"
      }
    ],
    "paid": true,
    "created_at": "2026-04-24T12:09:25.365Z",
    "first_message_content": "string",
    "test_type": "btob",
    "completed": false,
    "score": 5.7,
    "btob_score": 10,
    "btoc_score": 0,
    "final_score": 10,
    "analysis_results": "string",
    "domain": "string",
    "summary": {
      "INBOX": 16
    },
    "tld": "string",
    "blacklist_links": [
      "string"
    ],
    "blacklist_sending_ip": [
      "string"
    ],
    "sending_provider": "google.com",
    "sending_reverse_dns_value": "mail-sor-f41.google.com",
    "automated": false,
    "automated_test_id": 8,
    "spam": false,
    "seedlist": 1,
    "is_warming": false,
    "autofix_triggered": false,
    "account": "string"
  }
]

Paginated spam tests. Each item includes first_message_content, scores and analysis_results once the test is completed.