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

# List test sets

> List test sets for your organization.



## OpenAPI

````yaml /api-reference/v1/test-sets-v1.yaml get /test-sets
openapi: 3.0.3
info:
  title: Test Sets API
  version: 1.0.0
  description: >
    API for managing test sets - collections of test cases for evaluation.


    Test sets organize test cases and can define parameters for test case
    generation.
  contact:
    name: Coval API Support
    url: https://coval.dev
    email: support@coval.dev
servers:
  - url: https://api.coval.dev/v1
    description: Production API
security:
  - apiKey: []
tags:
  - name: Test Sets
    description: Operations for managing test sets
paths:
  /test-sets:
    get:
      tags:
        - Test Sets
      summary: List test sets
      description: List test sets for your organization.
      operationId: listTestSets
      parameters:
        - name: filter
          in: query
          description: >
            Filter expression syntax.

            Values may be unquoted or double-quoted. Values containing spaces
            must be quoted.

            Example: `test_set_type=SCENARIO`
          schema:
            type: string
          example: test_set_type=SCENARIO
        - name: page_size
          in: query
          description: Maximum number of test sets to return (default 50, max 100)
          schema:
            type: integer
            default: 50
            maximum: 100
        - name: page_token
          in: query
          description: Token for retrieving the next page of results
          schema:
            type: string
        - name: order_by
          in: query
          description: |
            Field to order results by. Prefix with `-` for descending order.
            Example: `-create_time` for newest first
          schema:
            type: string
            default: '-update_time'
          example: '-create_time'
        - name: tag_filters
          in: query
          description: >
            Filter test sets by tags. A resource matches when it has ALL the
            listed tags (AND-semantics).


            Repeat the parameter for each tag (e.g.,
            `?tag_filters=production&tag_filters=regression`).
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
            maxItems: 20
          example:
            - regression
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  test_sets:
                    type: array
                    items:
                      $ref: '#/components/schemas/TestSetResource'
                  next_page_token:
                    type: string
                    description: Token for retrieving the next page (empty if last page)
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    TestSetResource:
      type: object
      description: |
        Test set resource representation.
      properties:
        name:
          type: string
          description: Resource name in format `test-sets/{id}`
          example: test-sets/abc12345
        id:
          type: string
          description: Test set ID (8-character ID)
          minLength: 8
          maxLength: 8
          example: abc12345
        slug:
          type: string
          description: URL-friendly identifier (unique per organization)
          example: customer-support-scenarios
        display_name:
          type: string
          description: Human-readable test set name
          example: Customer Support Scenarios
        description:
          type: string
          nullable: true
          description: Test set description
          example: Test cases for customer support agent
        test_set_type:
          type: string
          nullable: true
          description: Test set type (e.g., DEFAULT, SCENARIO, TRANSCRIPT, WORKFLOW)
          example: SCENARIO
        test_set_metadata:
          type: object
          description: Additional test set configuration (JSON)
          additionalProperties: true
          example:
            category: support
            priority: high
        parameters:
          type: object
          description: 'Test case parameterization (e.g., {"name": ["Alice", "Bob"]})'
          additionalProperties: true
          example:
            customer_name:
              - Alice
              - Bob
            issue_type:
              - billing
              - technical
        test_case_count:
          type: integer
          description: Number of active test cases (GET endpoint only)
          example: 42
        tags:
          type: array
          description: Tags associated with this test set
          items:
            type: string
          default: []
          example:
            - regression
            - voice
        create_time:
          type: string
          format: date-time
          description: Timestamp when test set was created
          example: '2025-10-14T12:00:00Z'
        update_time:
          type: string
          format: date-time
          nullable: true
          description: Timestamp when test set was last updated
          example: '2025-10-15T14:30:00Z'
    ErrorResponse:
      type: object
      description: Standard error response
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - details
          properties:
            code:
              type: string
              description: Machine-readable error code
              example: INVALID_ARGUMENT
            message:
              type: string
              description: Human-readable error message
              example: Invalid request parameters
            details:
              type: array
              description: Detailed error information
              items:
                type: object
                properties:
                  field:
                    type: string
                    description: Field that caused the error
                    example: slug
                  description:
                    type: string
                    description: Description of the error
                    example: slug already exists for this organization
  responses:
    Unauthorized:
      description: Authentication failed or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: UNAUTHENTICATED
              message: Authentication failed
              details:
                - field: X-API-Key
                  description: Invalid or missing API key
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: INTERNAL
              message: Internal server error
              details:
                - description: An unexpected error occurred while processing the request
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Organization API key for authentication

````