> ## Documentation Index
> Fetch the complete documentation index at: https://docs.docketqa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tests

Retrieve all test blueprints in your account with their last run information.

## Query parameters

<ParamField query="type" type="string">
  Filter by blueprint type. Must be one of: `"integration"`, `"module"`, `"step_module"`.
</ParamField>

<ParamField query="test_blueprint_category_id" type="string">
  Filter by test suite ID. Pass `"none"` to get tests with no suite.
</ParamField>

<ParamField query="folder_path" type="string">
  Filter by folder path. Defaults to `"/"` (root folder).
</ParamField>

<ParamField query="include_all_folders" type="boolean">
  If `true`, return tests from all folders. Defaults to `false`.
</ParamField>

<ParamField query="search" type="string">
  Search tests by title (case-insensitive partial match).
</ParamField>

<ParamField query="include_usage_count" type="boolean">
  If `true`, include `used_by_integration_count` for module-type blueprints. Defaults to `false`.
</ParamField>

<ParamField query="page" type="integer">
  Page number for pagination (1-indexed). Use with `per_page`.
</ParamField>

<ParamField query="per_page" type="integer">
  Number of results per page. Enables pagination when set.
</ParamField>

<ParamField query="offset" type="integer">
  Offset for pagination. Use with `limit` as an alternative to `page`/`per_page`.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of results. Use with `offset`.
</ParamField>

## Response

<ResponseField name="test_blueprints" type="object[]">
  An array of test blueprint objects.

  <Expandable title="Test blueprint properties">
    <ResponseField name="id" type="integer">
      The unique ID of the test blueprint.
    </ResponseField>

    <ResponseField name="title" type="string">
      The test name.
    </ResponseField>

    <ResponseField name="type" type="string">
      The blueprint type (`"integration"`, `"module"`, or `"step_module"`).
    </ResponseField>

    <ResponseField name="status" type="string">
      The test status: `"active"` or `"paused"`.
    </ResponseField>

    <ResponseField name="device_type" type="string">
      The device type (`"browser"`, `"android"`, or `"ios"`).
    </ResponseField>

    <ResponseField name="device_name" type="string">
      The device name, if set.
    </ResponseField>

    <ResponseField name="starting_url" type="string">
      The starting URL for the test.
    </ResponseField>

    <ResponseField name="starting_prompt" type="string">
      The high-level description, if set.
    </ResponseField>

    <ResponseField name="step_count" type="integer">
      The number of steps in the test.
    </ResponseField>

    <ResponseField name="test_blueprint_category_id" type="integer">
      The test suite this test belongs to.
    </ResponseField>

    <ResponseField name="test_blueprint_category_name" type="string">
      The name of the test suite.
    </ResponseField>

    <ResponseField name="last_run" type="string">
      ISO 8601 timestamp of the most recent run, or `null`.
    </ResponseField>

    <ResponseField name="last_status" type="string">
      The result of the most recent run (`"passed"`, `"failed"`, `"running"`), or `null`.
    </ResponseField>

    <ResponseField name="company_id" type="integer">
      Your company ID.
    </ResponseField>

    <ResponseField name="created_by" type="integer">
      The ID of the user who created the test.
    </ResponseField>

    <ResponseField name="browser_zoom" type="number">
      The browser zoom level.
    </ResponseField>

    <ResponseField name="viewport_width" type="integer">
      Browser viewport width in pixels.
    </ResponseField>

    <ResponseField name="viewport_height" type="integer">
      Browser viewport height in pixels.
    </ResponseField>

    <ResponseField name="num_retries" type="integer">
      Number of automatic retries on failure.
    </ResponseField>

    <ResponseField name="reset_browser_on_retry" type="boolean">
      Whether the browser resets on retry.
    </ResponseField>

    <ResponseField name="typing_speed" type="integer">
      Typing speed in milliseconds per character, or `null` for default.
    </ResponseField>

    <ResponseField name="persist_self_healed" type="boolean">
      Whether self-healed caches are persisted.
    </ResponseField>

    <ResponseField name="file_download_mode" type="string">
      The file download handling mode (`"save_only"` or `"ingest_content"`).
    </ResponseField>

    <ResponseField name="files" type="object[]">
      Files attached to this test.
    </ResponseField>

    <ResponseField name="variables" type="object[]">
      Variables defined for this test.
    </ResponseField>

    <ResponseField name="setup_module" type="integer">
      The setup module ID, if set.
    </ResponseField>

    <ResponseField name="teardown_module" type="integer">
      The teardown module ID, if set.
    </ResponseField>

    <ResponseField name="folder_path" type="string">
      The folder path of the test.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the test was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of the last update.
    </ResponseField>

    <ResponseField name="used_by_integration_count" type="integer">
      Number of integration tests using this module. Only present when `include_usage_count=true` and `type` is `module`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata. Only included when using `page`/`per_page` or `offset`/`limit` parameters.

  <Expandable title="Pagination properties">
    <ResponseField name="page" type="integer">
      The current page number.
    </ResponseField>

    <ResponseField name="per_page" type="integer">
      Results per page.
    </ResponseField>

    <ResponseField name="total" type="integer">
      Total number of matching results.
    </ResponseField>

    <ResponseField name="total_pages" type="integer">
      Total number of pages.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="subfolders" type="string[]">
  List of subfolder paths within the current folder. Not included when using `search` or `include_all_folders`.
</ResponseField>

### Example response

```json theme={null}
{
  "test_blueprints": [
    {
      "id": 446,
      "title": "Randomized Campaign Creation",
      "type": "integration",
      "status": "active",
      "device_type": "browser",
      "device_name": null,
      "starting_url": "https://app.example.com/",
      "starting_prompt": null,
      "step_count": 38,
      "test_blueprint_category_id": 26,
      "test_blueprint_category_name": "Campaigns",
      "last_run": "2025-10-10T21:05:19.847072+00:00",
      "last_status": "failed",
      "company_id": 3,
      "created_by": 5,
      "browser_zoom": 1.0,
      "viewport_width": 1440,
      "viewport_height": 900,
      "num_retries": 0,
      "reset_browser_on_retry": true,
      "typing_speed": null,
      "persist_self_healed": true,
      "file_download_mode": "save_only",
      "files": [],
      "variables": [],
      "setup_module": null,
      "teardown_module": null,
      "folder_path": "/",
      "created_at": "2025-10-07T00:53:44.522824+00:00",
      "updated_at": "2025-10-07T00:54:00.587872+00:00"
    }
  ],
  "subfolders": ["/E2E Tests", "/Smoke Tests"]
}
```