> ## Documentation Index > Fetch the complete documentation index at: https://docs.tester.army/llms.txt > Use this file to discover all available pages before exploring further. # List tests > List tests for a project, optionally scoped to a test group. Use `cursor` for pagination; the response includes `nextCursor` when more pages exist. ## OpenAPI ````yaml /openapi.json get /v1/tests openapi: 3.0.0 info: title: TestArmy API version: 1.0.0 description: >- AI-powered browser automation API for QA testing. Automate web testing workflows using natural language prompts. servers: - url: https://tester.army/api description: Production API server security: [] paths: /v1/tests: get: tags: - Tests summary: List tests description: >- List tests for a project, optionally scoped to a test group. Use `cursor` for pagination; the response includes `nextCursor` when more pages exist. parameters: - schema: type: string description: Project ID required: true description: Project ID name: projectId in: query - schema: type: string format: uuid description: Optional test group ID required: false description: Optional test group ID name: groupId in: query - schema: type: string pattern: ^(?:[1-9]|[1-9][0-9]|100)$ description: Max results per page (default 50, max 100) required: false description: Max results per page (default 50, max 100) name: limit in: query - schema: type: string description: Cursor for pagination required: false description: Cursor for pagination name: cursor in: query responses: '200': description: List of tests content: application/json: schema: type: object properties: projectUrl: type: string nullable: true format: uri projectName: type: string tests: type: array items: $ref: '#/components/schemas/TestDefinition' nextCursor: type: string nullable: true required: - projectUrl - projectName - tests - nextCursor '400': description: Bad Request - Invalid input parameters content: application/json: schema: type: object properties: error: type: string description: Error code or type message: type: string description: Human-readable error message required: - error - message '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string description: Error code or type message: type: string description: Human-readable error message required: - error - message '404': description: Not Found - Resource does not exist or is not accessible content: application/json: schema: type: object properties: error: type: string description: Error code or type message: type: string description: Human-readable error message required: - error - message '429': description: Too Many Requests - Usage limit exceeded content: application/json: schema: type: object properties: error: type: string description: Error code or type message: type: string description: Human-readable error message required: - error - message '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string description: Error code or type message: type: string description: Human-readable error message required: - error - message '504': description: Gateway Timeout - Test execution exceeded time limit content: application/json: schema: type: object properties: error: type: string description: Error code or type message: type: string description: Human-readable error message required: - error - message security: - bearerAuth: [] components: schemas: TestDefinition: type: object properties: id: type: string format: uuid title: type: string description: type: string nullable: true enabled: type: boolean platform: type: string enum: - web - mobile settings: $ref: '#/components/schemas/TestSettings' steps: type: array items: $ref: '#/components/schemas/TestStep' projectId: type: string format: uuid projectUrl: type: string nullable: true format: uri projectName: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - id - title - steps TestSettings: type: object properties: executionMode: type: string enum: - fast - deep description: deep uses a higher-effort model for complex steps. browserRegion: type: string nullable: true enum: - eu - us - null description: Per-test proxy exit region. null falls back to the project's region. simulatorRegion: type: string enum: - eu-north1 - us-west1 description: Region the simulator or emulator runs in. Mobile tests only. viewport: type: string nullable: true enum: - desktop - desktop-hd - mobile - tablet - null description: >- Browser viewport preset: desktop (1280x800), desktop-hd (1920x1080), mobile (390x844), tablet (768x1024). null restores the default. Web tests only. webSearchEnabled: type: boolean description: Allow the test to use internet search for factual checks. prepGroupId: type: string nullable: true format: uuid description: Group whose preparation test a solo run of this test uses. TestStep: oneOf: - type: object properties: title: type: string minLength: 1 maxLength: 2000 type: type: string enum: - act disabled: type: boolean description: >- When true, the step stays saved on the test but is skipped during runs. required: - title - type - type: object properties: title: type: string minLength: 1 maxLength: 2000 type: type: string enum: - assert disabled: type: boolean description: >- When true, the step stays saved on the test but is skipped during runs. required: - title - type - type: object properties: title: type: string maxLength: 2000 type: type: string enum: - login credentialId: type: string format: uuid temporaryEmail: type: boolean disabled: type: boolean description: >- When true, the step stays saved on the test but is skipped during runs. required: - title - type - type: object properties: title: type: string maxLength: 2000 type: type: string enum: - files fileIds: type: array items: type: string format: uuid disabled: type: boolean description: >- When true, the step stays saved on the test but is skipped during runs. required: - title - type - fileIds - type: object properties: title: type: string maxLength: 2000 type: type: string enum: - screenshot disabled: type: boolean description: >- When true, the step stays saved on the test but is skipped during runs. required: - type - type: object properties: title: type: string maxLength: 2000 type: type: string enum: - javascript code: type: string maxLength: 10000 description: >- JavaScript run in the browser page. Runs as an awaited function body; passes if it completes without throwing (returns nothing or { success: true }) and fails if it returns { success: false, reason } or throws. Web tests only. disabled: type: boolean description: >- When true, the step stays saved on the test but is skipped during runs. required: - type - code - type: object properties: title: type: string maxLength: 2000 type: type: string enum: - microphone fileId: anyOf: - type: string format: uuid - type: string enum: - '' description: >- Project file ID (UUID) of the audio file (e.g. MP3) to play through the microphone. Empty string marks an unconfigured draft that must have a file attached before the test runs. mode: type: string enum: - blocking - loop description: >- blocking: the agent waits for playback to finish before continuing. loop: playback repeats until the run ends and the agent continues immediately. Web tests only. disabled: type: boolean description: >- When true, the step stays saved on the test but is skipped during runs. required: - type - fileId - mode securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: API key authentication using Bearer token format ````