Skip to content
Mailgun Inspect/API Documentation/
/
List Spam Tests (V1)

List Spam Tests (V1)

Request

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

Security
basicAuth
Query
statusstring

Filter by spam test lifecycle status

Enum ValueDescription
pending

Test created.

processing

Test accepted; seeds still delivering

completed

Results fully mapped and persisted

failed

Unrecoverable error during test execution

regionstring

Filter by sending region

Enum ValueDescription
us1

United States region

eu1

European Union region

sort_bystring

Field to sort by

Enum ValueDescription
created_at

Sort by creation time (default)

updated_at

Sort by last update time

sort_orderstring

Sort direction

Enum ValueDescription
desc

Descending (default)

asc

Ascending

limitintegerrequired

Limits the number of items returned in a request

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v1/inspect/spam?status=pending&region=us1&sort_by=created_at&sort_order=desc&limit=0'

Responses

A 200 response

Bodyapplication/json
metaobject(github.com-mailgun-inspect-internal-spam-ResponseMeta)required
paginggithub.com-mailgun-scaffold-httpapi-paging-PagingResponse (object) or null
Any of:
itemsArray of objects(github.com-mailgun-inspect-internal-spam-SpamTestResource)required
Response
{
  "meta": {},
  "items": [
    { … },
    { … }
  ],
  "links": {}
}