# List all parent tests

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /email-placement/list/parent-tests:
    get:
      summary: List all parent tests
      deprecated: false
      description: >-
        Retrieve a paginated list of parent tests with optional filtering and
        sorting.
      operationId: listParentTests
      tags:
        - Email Placement Test/Parent Recurring Test
        - Parent Tests
      parameters:
        - name: workspace_id
          in: query
          description: Workspace ID
          required: true
          example: 65f3c92d3dbe5dbb35374a9a
          schema:
            type: string
            pattern: ^[a-f0-9]{24}$
        - name: status
          in: query
          description: Filter by test status
          required: false
          schema:
            type: string
            enum:
              - DRAFT
              - ACTIVE
              - INACTIVE
            x-apidog-enum:
              - value: DRAFT
                name: ''
                description: ''
              - value: ACTIVE
                name: ''
                description: ''
              - value: INACTIVE
                name: ''
                description: ''
        - name: type
          in: query
          description: Filter by test type (AUTOMATIC)
          required: false
          schema:
            type: string
            enum:
              - AUTOMATIC
            x-apidog-enum:
              - value: AUTOMATIC
                name: ''
                description: ''
        - name: limit
          in: query
          description: Number of results per page
          required: false
          schema:
            type: integer
            minimum: 1
            default: 50
        - name: page
          in: query
          description: Page number
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
      responses:
        '200':
          description: List retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    examples:
                      - 1
                  message:
                    type: string
                    examples:
                      - Tests retrieved successfully
                  data:
                    type: object
                    properties:
                      tests:
                        type: array
                        items:
                          $ref: '#/components/schemas/ParentTest'
                      pagination:
                        type: object
                        properties:
                          total:
                            type: integer
                          page:
                            type: integer
                          limit:
                            type: integer
                          pages:
                            type: integer
                        x-apidog-orders:
                          - total
                          - page
                          - limit
                          - pages
                        x-apidog-ignore-properties: []
                    x-apidog-orders:
                      - tests
                      - pagination
                    x-apidog-ignore-properties: []
                x-apidog-orders:
                  - status
                  - message
                  - data
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: ''
        '400':
          description: Bad request - validation error or missing required fields
          content:
            application/json:
              schema: &ref_0
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: 0
                message: Validation error
                error: Validation error
                errors:
                  - workspace_id is required
                  - api_key must be a valid string
          headers: {}
          x-apidog-name: BadRequest
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema: *ref_0
              example:
                status: 0
                message: Unauthorized
                error: Invalid API key
          headers: {}
          x-apidog-name: Unauthorized
      security:
        - ApiKeyAuth: []
          x-apidog:
            schemeGroups:
              - id: uS5KiuC4wfZHK42AzOfA_
                schemeIds:
                  - ApiKeyAuth
            required: true
            use:
              id: uS5KiuC4wfZHK42AzOfA_
            scopes:
              uS5KiuC4wfZHK42AzOfA_:
                ApiKeyAuth: []
      x-apidog-folder: Email Placement Test/Parent Recurring Test
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/929054/apis/api-28696781-run
components:
  schemas:
    ParentTest:
      type: object
      properties:
        _id:
          type: string
          examples:
            - 65f3c92d3dbe5dbb35374abc
        name:
          type: string
          examples:
            - Q1 2024 Deliverability Test
        type:
          type: string
          enum:
            - AUTOMATIC
            - MANUAL
        status:
          type: string
          enum:
            - DRAFT
            - ACTIVE
            - PAUSED
            - INACTIVE
        total_tests:
          type: integer
          examples:
            - 15
        compl_tests:
          type: integer
          examples:
            - 12
        created_at:
          type: string
          format: date-time
      x-apidog-orders:
        - _id
        - name
        - type
        - status
        - total_tests
        - compl_tests
        - created_at
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    ErrorResponse:
      type: object
      required:
        - code
        - message
        - data
      properties:
        code:
          type: integer
          enum:
            - 0
        message:
          type: string
        data:
          type: object
          x-apidog-orders: []
          properties: {}
          x-apidog-ignore-properties: []
      x-apidog-orders:
        - code
        - message
        - data
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    ApiKeyAuth:
      type: apikey
      in: header
      name: x-api-key
      description: |
        API key issued in the PlusVibe dashboard. The server reads it
        from the `x-api-key` header and injects it into the request as
        the `api_key` query parameter, which is why you will see
        `api_key` referenced in validation errors.
    apiKey:
      type: apikey
      in: body
      name: api_key
      description: API key passed in request body
servers:
  - url: https://api.plusvibe.ai/api/v1
    description: Prod Env
security:
  - ApiKeyAuth: []
    x-apidog:
      schemeGroups:
        - id: uS5KiuC4wfZHK42AzOfA_
          schemeIds:
            - ApiKeyAuth
      required: true
      use:
        id: uS5KiuC4wfZHK42AzOfA_
      scopes:
        uS5KiuC4wfZHK42AzOfA_:
          ApiKeyAuth: []

```