> ## Documentation Index > Fetch the complete documentation index at: https://docs.qa.tech/llms.txt > Use this file to discover all available pages before exploring further. # List runs > Lists runs for the project, newest first. With no filters it returns the 20 most recent runs across all time; pass `since`/`until` (ISO 8601) to scope to a window such as the last 24 hours. Returned `shortId`s work directly with `get_run` and `rerun_run`. ## OpenAPI ````yaml /api-reference/api.json get /v1/run openapi: 3.0.0 info: title: QA.tech API version: 1.0.0 contact: name: QA.tech url: https://qa.tech email: support@qa.tech description: API for triggering and managing AI-powered test runs servers: - url: https://api.qa.tech description: Production variables: {} security: - BearerAuth: [] tags: - name: Runs - name: Infrastructure - name: Test Cases - name: Application Builds - name: Status badge - name: Remote Tunnels - name: Chat - name: Applications - name: Features - name: Metrics - name: Release Checks - name: Projects paths: /v1/run: get: tags: - Runs summary: List runs description: >- Lists runs for the project, newest first. With no filters it returns the 20 most recent runs across all time; pass `since`/`until` (ISO 8601) to scope to a window such as the last 24 hours. Returned `shortId`s work directly with `get_run` and `rerun_run`. operationId: ListRuns parameters: - name: query in: query required: true schema: $ref: '#/components/schemas/ListRunsQuery' explode: false responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/ListRunsResponse' components: schemas: ListRunsQuery: type: object properties: applicationShortId: allOf: - $ref: '#/components/schemas/ApplicationShortId' description: Scope to runs that executed against this application. testPlanShortId: allOf: - $ref: '#/components/schemas/TestPlanShortId' description: Scope to runs triggered for this test plan. status: type: string enum: - running - passed - failed - errored - cancelled description: >- Filter by run outcome. `running` covers initiated/running runs; `passed`/`failed` match the run result; `errored`/`cancelled` match the run status. trigger: type: string enum: - API - GITHUB - MANUAL - SCHEDULE - CHAT description: Filter by how the run was triggered. branch: type: string minLength: 1 description: Filter GITHUB-triggered runs by branch name. commitHash: type: string minLength: 1 description: Filter GITHUB-triggered runs by commit hash. since: allOf: - $ref: '#/components/schemas/Iso8601Timestamp' description: Only include runs started at or after this ISO 8601 timestamp. until: allOf: - $ref: '#/components/schemas/Iso8601Timestamp' description: Only include runs started at or before this ISO 8601 timestamp. orderBy: type: string enum: - startedAt - createdAt - completedAt description: Field to sort by. Defaults to `startedAt`. default: startedAt orderDirection: type: string enum: - asc - desc description: Sort direction. Defaults to `desc` (newest first). default: desc limit: type: integer format: int32 minimum: 1 maximum: 100 description: Maximum number of runs to return (1-100). Defaults to 20. default: 20 offset: type: integer format: int32 minimum: 0 description: Number of runs to skip for pagination. Defaults to 0. projectShortId: allOf: - $ref: '#/components/schemas/ProjectShortId' description: >- Target a specific project by its prefixed short ID (proj-slug_shortId or proj_shortId), as returned by the projects API. Required for organization-scoped API keys; project-scoped keys may only pass their own project's short ID. description: >- Filters for listing runs. Every filter is optional; with no filters the most recent runs across all time are returned, newest first. ListRunsResponse: type: object required: - runs - total - limit - offset properties: runs: type: array items: $ref: '#/components/schemas/ListRunItem' total: type: integer format: int32 limit: type: integer format: int32 offset: type: integer format: int32 ApplicationShortId: type: string pattern: ^app(-.+_.+|_.+)$ TestPlanShortId: type: string pattern: ^pln(-.+_.+|_.+)$ Iso8601Timestamp: type: string pattern: >- ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])([Tt ]([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?(\.\d+)?([Zz]|[+-]([01]\d|2[0-3]):?[0-5]\d)?)?$ ProjectShortId: type: string pattern: ^proj(-.+_.+|_.+)$ ListRunItem: type: object required: - shortId - status - result - trigger - branch - commitHash - testPlanShortId - applicationShortIds - startedAt - finishedAt - createdAt - passedCount - failedCount - erroredCount - skippedCount - cancelledCount - totalCount - url properties: shortId: type: string status: type: string result: type: string nullable: true trigger: type: string branch: type: string nullable: true commitHash: type: string nullable: true testPlanShortId: type: string nullable: true applicationShortIds: type: array items: type: string description: >- Applications the run executed against. Empty when the run had no environment association. startedAt: type: string nullable: true finishedAt: type: string nullable: true createdAt: type: string passedCount: type: integer format: int32 failedCount: type: integer format: int32 erroredCount: type: integer format: int32 skippedCount: type: integer format: int32 cancelledCount: type: integer format: int32 totalCount: type: integer format: int32 url: type: string securitySchemes: BearerAuth: type: http scheme: Bearer ````