# List/Search Tests V2

This call returns a list of Email Tests along with metadata about each test. Email Tests are stored for 90 days. When query parameters are provided, only the tests matching the specified criteria will be returned; otherwise, all available tests are returned. The response structure remains identical in both cases.

Endpoint: GET /v2/preview/tests
Version: 1.0.0
Security: basicAuth

## Query parameters:

  - `customer_id` (string)
    Filter tests by the provided customer ID.

  - `from` (string)
    The starting point of your test date range. Accepts formats like '2025-03-10 17:52:07', Unix timestamp, or 'yesterday'.

  - `to` (string)
    The ending point of your test date range. Accepts formats like '2025-03-10 17:52:07', Unix timestamp, or 'yesterday'.

  - `subject` (string)
    The "subject" field of returned tests must contain the exact string. This search is case-insensitive.

  - `headers` (string)
    Enterprise users can use this field in a KV array of x-headers submitted with the test. This is an AND match, meaning all headers must be present to return.

  - `results` (integer)
    The number of results to return. Must be between 1 and 200. The default value is 50.

  - `page` (integer)
    The page number. If you submit a number higher than the number of pages in the data, an empty array will be returned. The default value is 1.

## Response 200 fields (application/json):

  - `id` (string)

  - `date` (integer)

  - `type` (string)

  - `subject` (string)

  - `headers` (object)

## Response 400 fields (application/json):

  - `Reason` (string, required)

## Response 401 fields (application/json):

  - `Reason` (string, required)

## Response 500 fields (application/json):

  - `message` (string, required)
    Response message

## Response default fields (application/json):

  - `error` (object)

  - `error.name` (string)

  - `error.message` (string)