> ## Documentation Index > Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get tests > Get list of tests with pagination and filtering options. See [Tests](https://docs.galtea.ai/concepts/product/test). ## OpenAPI ````yaml https://api.galtea.ai/openapi.json get /tests openapi: 3.0.0 info: version: 1.0.0 title: Product Management Service API description: API documentation for Product Management Service contact: name: Galtea AI servers: - url: https://api.galtea.ai security: - bearerAuth: [] tags: [] externalDocs: description: Galtea Platform Documentation url: https://docs.galtea.ai paths: /tests: get: tags: - tests summary: Get tests description: >- Get list of tests with pagination and filtering options. See [Tests](https://docs.galtea.ai/concepts/product/test). operationId: getTests parameters: - name: ids in: query style: form explode: true description: Filter by test IDs required: false schema: type: array items: type: string - name: productIds in: query style: form explode: true description: Filter by product IDs required: false schema: type: array items: type: string - name: testCaseIds in: query style: form explode: true description: Filter by test case IDs required: false schema: type: array items: type: string - name: versionIds in: query style: form explode: true description: Filter by version IDs required: false schema: type: array items: type: string - name: names in: query style: form explode: true description: Filter by test names (exact match, multiple) required: false schema: type: array items: type: string - name: name in: query description: Filter by test name (partial match) required: false schema: type: string - name: types in: query style: form explode: true description: Filter by test types required: false schema: type: array items: type: string - name: specificationIds in: query style: form explode: true description: Filter by specification IDs required: false schema: type: array items: type: string - name: existentInEvaluations in: query description: Filter tests that have evaluations required: false schema: type: boolean - name: hasInferenceResults in: query description: Filter tests that have inference results required: false schema: type: boolean - name: sort in: query style: form explode: true description: Sort instructions (field and direction pairs) required: false schema: type: array items: type: string - name: limit in: query description: Maximum number of results required: false schema: type: integer - name: offset in: query description: Number of results to skip required: false schema: type: integer - name: fromCreatedAt in: query description: Filter tests created at or after this timestamp (ISO 8601 format) required: false schema: type: string format: date-time - name: toCreatedAt in: query description: Filter tests created at or before this timestamp (ISO 8601 format) required: false schema: type: string format: date-time responses: '200': description: Tests retrieved successfully content: application/json: schema: type: array items: $ref: '#/components/schemas/Test' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: Test: type: object properties: id: type: string example: test_123 productId: type: string nullable: true example: prod_123 userId: type: string nullable: true example: user_123 name: type: string example: Quality Test type: type: string enum: - QUALITY - RED_TEAMING - SCENARIOS example: QUALITY groundTruthUri: type: string nullable: true example: s3://my-bucket/tests/test_123/ground-truth.csv description: >- Canonical storage URI of the ground-truth file, derived from the presigned URL supplied at creation. S3: `s3:///`. Azure Blob: blob URL with the SAS query stripped (e.g. `https://.blob.core.windows.net//`). uri: type: string nullable: true example: s3://my-bucket/tests/test_123/test.csv description: >- Canonical storage URI of the uploaded custom test file. Same format rules as `groundTruthUri`. error: type: string nullable: true status: type: string enum: - PENDING - SUCCESS - FAILED - AUGMENTING example: SUCCESS fewShot: type: string nullable: true example: Example few-shot learning data description: >- Optional few-shot examples (input/output pairs) used to guide test-case generation for QUALITY tests. languageCode: type: string nullable: true example: es-MX description: >- BCP-47 language tag (e.g. en, es-MX). The region subtag affects voice synthesis only. backgroundNoiseProfile: type: string nullable: true enum: - office - street - car - white - pink example: street description: >- Background noise mixed into the simulated caller audio during a voice test. Clip-backed (office, street, car) or synthetic (white, pink). Null means off; set together with backgroundNoiseLevel. backgroundNoiseLevel: type: string nullable: true enum: - light - medium - heavy example: medium description: >- How loud the background noise is relative to the caller speech. Null means off; set together with backgroundNoiseProfile. variants: type: array items: type: string example: - rag - summarization description: >- Test variants. QUALITY: rag, entity_extraction, summarization, classification, translation, correction, other. RED_TEAMING: data_leakage, financial_attacks, illegal_activities, misuse, toxicity, custom. customVariantDescription: type: string nullable: true example: Custom variant description strategies: type: array items: type: string example: - original description: >- Generation strategies. "original" is the default for RED_TEAMING. At least one strategy is required for SCENARIOS tests. customUserPersona: type: string nullable: true example: Business analyst maxTestCases: type: integer nullable: true example: 100 models: type: array items: type: string example: - gpt-4 - claude-3 sourceTestId: type: string nullable: true dataCatalogUri: type: string nullable: true example: s3://my-bucket/tests/test_123/data-catalog.json description: >- Canonical storage URI of the data-catalog file (SCENARIOS tests only). Same format rules as `groundTruthUri`. metadata: type: object nullable: true example: key: value specificationId: type: string nullable: true example: spec_123 createdAt: type: string format: date-time deletedAt: type: string format: date-time nullable: true Error: type: object properties: error: type: string example: Error type message: type: string example: Error message description securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (`gsk_*`) and legacy (`gsk-`) API keys are accepted, e.g. `Authorization: Bearer gsk_...` or `Authorization: Bearer gsk-...`. ````