> ## Documentation Index > Fetch the complete documentation index at: https://docs.valiqor.com/llms.txt > Use this file to discover all available pages before exploring further. # List analysis runs > List failure analysis runs for the current project ## OpenAPI ````yaml openapi.json get /v2/failure-analysis/runs openapi: 3.1.0 info: title: Valiqor API description: >- The Valiqor API provides programmatic access to AI application testing, evaluation, failure analysis, and security auditing. ## Authentication All API requests require an API key passed as a Bearer token in the `Authorization` header: ``` Authorization: Bearer vq-xxxxxxxxxxxxxxxxxxxx ``` Get your API key from the [Valiqor Dashboard](https://app.valiqor.com) or via `valiqor login` CLI command. ## Base URL ``` https://api.valiqor.com ``` version: 2.0.0 contact: name: Valiqor Support url: https://valiqor.com email: support@valiqor.com servers: - url: https://api.valiqor.com description: Production security: [] tags: - name: Authentication description: >- API key validation, user management, device authorization flow, and CLI authentication. All SDK requests require a valid API key passed as a Bearer token. - name: Evaluation description: >- Run quality evaluations on datasets or traces. Compute metrics like faithfulness, relevance, coherence, and more. Compare runs and track trends over time. - name: Security description: >- Security audits (S1-S23 safety categories) and red team simulations. Detect prompt injection, harmful content, data leakage, and other vulnerabilities. - name: Failure Analysis description: >- Analyze AI app failures with root cause detection, severity scoring, and actionable fix suggestions. Supports both trace-based (full) and dataset-based (minimal) analysis modes. - name: Tracing description: >- Upload and query execution traces from AI applications. Traces capture messages, spans, tool calls, retrievals, and LLM interactions for debugging and evaluation. - name: Scanner description: >- Upload code scans to detect AI app features, workflows, and prompts. Generates evaluation configurations automatically from your codebase. - name: Projects description: >- Create and manage projects. Projects are containers that organize evaluation runs, security audits, traces, and failure analysis results. paths: /v2/failure-analysis/runs: get: tags: - Failure Analysis summary: List analysis runs description: List failure analysis runs for the current project operationId: list_runs_v2_failure_analysis_runs parameters: - name: project_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by project ID title: Project Id description: Filter by project ID - name: status in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by status title: Status description: Filter by status - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page default: 20 title: Page Size description: Items per page responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/FARunListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyAuth: [] components: schemas: FARunListResponse: properties: items: items: $ref: '#/components/schemas/FARunListItem' type: array title: Items total: type: integer title: Total page: type: integer title: Page page_size: type: integer title: Page Size has_more: type: boolean title: Has More type: object required: - items - total - page - page_size - has_more title: FARunListResponse description: Paginated list of FA runs. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError FARunListItem: properties: run_id: type: string title: Run Id status: type: string title: Status input_type: type: string title: Input Type feature_kind: anyOf: - type: string - type: 'null' title: Feature Kind minimal_mode: type: boolean title: Minimal Mode dataset_item_count: type: integer title: Dataset Item Count project_name: anyOf: - type: string - type: 'null' title: Project Name trace_id: anyOf: - type: string - type: 'null' title: Trace Id total_failures_detected: anyOf: - type: integer - type: 'null' title: Total Failures Detected total_passes: anyOf: - type: integer - type: 'null' title: Total Passes primary_failure: anyOf: - type: string - type: 'null' title: Primary Failure overall_severity: anyOf: - type: number - type: 'null' title: Overall Severity eval_run_id: anyOf: - type: string - type: 'null' title: Eval Run Id security_batch_id: anyOf: - type: string - type: 'null' title: Security Batch Id has_security_issues: anyOf: - type: boolean - type: 'null' title: Has Security Issues created_at: type: string format: date-time title: Created At duration_ms: anyOf: - type: integer - type: 'null' title: Duration Ms type: object required: - run_id - status - input_type - feature_kind - minimal_mode - dataset_item_count - created_at title: FARunListItem description: Summary item for FA runs list. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyAuth: type: http scheme: bearer description: >- Valiqor API key. Pass as Bearer token: `Authorization: Bearer vq-xxxxxxxxxxxxxxxxxxxx` ````