---
title: "Get Spam Test (V1)"
method: GET
path: "/v1/inspect/spam/{spam_test_id}"
tags: ["Spam Testing"]
---

# Get Spam Test (V1)

`GET /v1/inspect/spam/{spam_test_id}`

## Request

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

Returns the current state of a spam test. A Retry-After: 10 header is set when the test is still processing.

## Path parameters

- `spam_test_id` string, required

## Response `200`

A 200 response

- GithubComMailgunInspectInternalSpamSpamTestItemResponse
  - `meta` GithubComMailgunInspectInternalSpamResponseMeta, required
    - `request_id` string, required
    - `timestamp` string, required
    - `count` integer, nullable
  - `item` 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

- `401`: A 401 response
- `404`: A 404 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)