# Spam Testing

The Spam Testing API scores inbox placement by submitting email content to seed accounts across major providers, reporting deliverability, spam filter verdicts, and authentication results to help maximize inbox reach.

## List Spam Tests (V1)

 - [GET /v1/inspect/spam](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/spam-testing/get-v1-inspect-spam.md): Returns a paginated list of all spam tests for the account, ordered by created_at desc. Supports filtering by status and region.

## Create Spam Test (V1)

 - [POST /v1/inspect/spam](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/spam-testing/post-v1-inspect-spam.md): Initiates an inbox placement test with subject and HTML provided directly in the request body. Returns immediately with status=processing; poll GET using the Retry-After interval.

## Get Spam Test (V1)

 - [GET /v1/inspect/spam/{spam_test_id}](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/spam-testing/get-v1-inspect-spam--spam-test-id-.md): Returns the current state of a spam test. A Retry-After: 10 header is set when the test is still processing.

## Delete Spam Test (V1)

 - [DELETE /v1/inspect/spam/{spam_test_id}](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/spam-testing/delete-v1-inspect-spam--spam-test-id-.md): Permanently deletes the spam test and its results.

## List Supported ESP Providers

 - [GET /v1/inspect/spam/providers](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/spam-testing/get-v1-inspect-spam-providers.md): Returns the static list of ESPs supported by spam testing, grouped by category (B2C / B2B).