# List Spam Tests (V1)

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

Endpoint: GET /v1/inspect/spam
Version: 1.0.0
Security: basicAuth

## Query parameters:

  - `status` (string)
    Filter by spam test lifecycle status

  - `region` (string)
    Filter by sending region

  - `sort_by` (string)
    Field to sort by

  - `sort_order` (string)
    Sort direction

  - `limit` (integer, required)
    Limits the number of items returned in a request

## Response 200 fields (application/json):

  - `meta` (object, required)

  - `meta.request_id` (string, required)

  - `meta.timestamp` (string, required)

  - `meta.count` (integer | null)

  - `paging` (any)

  - `paging.previous` (string, required)
    Previous page URL

  - `paging.first` (string, required)
    First page URL

  - `paging.next` (string, required)
    Next page URL

  - `paging.last` (string, required)
    Last page URL

  - `items` (array, required)

  - `items.id` (string, required)

  - `items.status` (string, required)

  - `items.subject` (string, required)

  - `items.sending_ip` (string | null)

  - `items.region` (string, required)

  - `items.results` (any)

  - `items.results.b2c` (object, required)

  - `items.results.b2c.passed` (integer, required)

  - `items.results.b2c.failed` (integer, required)

  - `items.results.b2c.pending` (integer, required)

  - `items.results.b2c.results` (array, required)

  - `items.results.b2c.results.esp` (string, required)

  - `items.results.b2c.results.display_name` (string, required)

  - `items.results.b2c.results.status` (string, required)

  - `items.results.b2c.results.placement` (string, required)

  - `items.results.b2c.results.folder` (string)
    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.
    Enum: "primary", "promotions", "social", "updates", "forums", "spam"

  - `items.failure_reason` (string | null)

  - `items.created_at` (string, required)

  - `items.updated_at` (string, required)

  - `links` (object, required)

  - `links.self` (string, required)

## Response 400 fields (application/json):

  - `message` (string, required)
    Response message

## Response 401 fields (application/json):

  - `message` (string, required)
    Response message