# 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
    Enum: "pending", "processing", "completed", "failed"

  - `region` (string)
    Filter by sending region
    Enum: "us1", "eu1"

  - `sort_by` (string)
    Field to sort by
    Enum: "created_at", "updated_at"

  - `sort_order` (string)
    Sort direction
    Enum: "desc", "asc"

  - `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)

  - `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.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