> ## 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. # Get FA security insights > Get aggregated security insights across FA runs that included security scans ## OpenAPI ````yaml openapi.json get /v2/failure-analysis/insights/security 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/insights/security: get: tags: - Failure Analysis summary: Get FA security insights description: >- Get aggregated security insights across FA runs that included security scans operationId: get_security_insights_v2_failure_analysis_insights_security parameters: - name: days in: query required: false schema: anyOf: - type: integer maximum: 365 minimum: 1 - type: 'null' description: Number of days to analyze (None = all time) default: 30 title: Days description: Number of days to analyze (None = all time) - name: project_name in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by project name title: Project Name description: Filter by project name responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/FASecurityInsightsSummary' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyAuth: [] components: schemas: FASecurityInsightsSummary: properties: total_runs_with_security: type: integer title: Total Runs With Security description: Total FA runs that included security scans default: 0 runs_with_issues: type: integer title: Runs With Issues description: Runs that had at least one security issue default: 0 total_issues_found: type: integer title: Total Issues Found description: Total security issues across all runs default: 0 issues_by_category: items: $ref: '#/components/schemas/SecurityCategoryIssue' type: array title: Issues By Category top_categories: items: $ref: '#/components/schemas/SecurityCategoryIssue' type: array title: Top Categories period_days: type: integer title: Period Days description: Number of days in the analysis period default: 30 period_start: anyOf: - type: string format: date-time - type: 'null' title: Period Start period_end: anyOf: - type: string format: date-time - type: 'null' title: Period End project_name: anyOf: - type: string - type: 'null' title: Project Name type: object title: FASecurityInsightsSummary description: >- Aggregated security insights across FA runs that included security scans. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SecurityCategoryIssue: properties: category_id: type: string title: Category Id description: Security category ID (e.g., S1, S2) category_name: type: string title: Category Name description: Human-readable category name issue_count: type: integer title: Issue Count description: Number of issues in this category default: 0 severity: type: string title: Severity description: Category severity level default: medium type: object required: - category_id - category_name title: SecurityCategoryIssue description: Security category with issue count. 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` ````