---
title: "List Spam Tests (V1)"
method: GET
path: "/v1/inspect/spam"
tags: ["Spam Testing"]
---

# List Spam Tests (V1)

`GET /v1/inspect/spam`

## Request

- Base URL: `https://api.mailgun.net`
- URL: `https://api.mailgun.net/v1/inspect/spam`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mailgun/apis/email-preview-api/docs/v1/inspect/spam/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of all spam tests for the account, ordered by created_at desc. Supports filtering by status and region.

## Query parameters

- `status` 'pending' | 'processing' | 'completed' | 'failed'
- `region` 'us1' | 'eu1'
- `sort_by` 'created_at' | 'updated_at'
- `sort_order` 'desc' | 'asc'
- `limit` integer, required

## Response `200`

A 200 response

- GithubComMailgunInspectInternalSpamSpamTestListResponse
  - `meta` GithubComMailgunInspectInternalSpamResponseMeta, required
    - `request_id` string, required
    - `timestamp` string, required
    - `count` integer, nullable
  - `paging` GithubComMailgunScaffoldHttpapiPagingPagingResponse
    - `previous` string, required: Previous page URL
    - `first` string, required: First page URL
    - `next` string, required: Next page URL
    - `last` string, required: Last page URL
  - `items` GithubComMailgunInspectInternalSpamSpamTestResource[], required
    - `id` string, required
    - `status` string, required
    - `subject` string, required
    - `sending_ip` string, nullable
    - `region` string, required
    - `results` GithubComMailgunInspectInternalSpamSpamTestResults
      - `b2c` GithubComMailgunInspectInternalSpamESPCategoryResults, required
        - `passed` integer, required
        - `failed` integer, required
        - `pending` integer, required
        - `results` GithubComMailgunInspectInternalSpamESPResult[], required
          - `esp` string, required
          - `display_name` string, required
          - `status` string, required
          - `placement` string, required
          - `folder` 'primary' | 'promotions' | 'social' | 'updates' | 'forums' | 'spam': Gmail tab the delivered message landed in, reported for Gmail and Google Workspace only. Omitted for every other ESP and while the seed is pending or missing.
      - `b2b` GithubComMailgunInspectInternalSpamESPCategoryResults, required
        - `passed` integer, required
        - `failed` integer, required
        - `pending` integer, required
        - `results` GithubComMailgunInspectInternalSpamESPResult[], required
          - `esp` string, required
          - `display_name` string, required
          - `status` string, required
          - `placement` string, required
          - `folder` 'primary' | 'promotions' | 'social' | 'updates' | 'forums' | 'spam': Gmail tab the delivered message landed in, reported for Gmail and Google Workspace only. Omitted for every other ESP and while the seed is pending or missing.
    - `failure_reason` string, nullable
    - `created_at` string, required
    - `updated_at` string, required
  - `links` GithubComMailgunInspectInternalSpamResponseLinks, required
    - `self` string, required

## Other responses

- `400`: A 400 response
- `401`: A 401 response

---

[API](https://skmtc.dev/mailgun/apis/email-preview-api.md) - [All operations](https://skmtc.dev/mailgun/apis/email-preview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailgun/apis/email-preview-api/revisions/c8a18f02bc8b?raw)