> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get success rate trend data

> Retrieve 7-day rolling average trend of simulation outcomes for visualization. Returns daily aggregated data showing successful vs failed runs.



## OpenAPI

````yaml https://api-trial.cognigy.ai/testing/openapi/openapi-viewer.json get /dashboard/success-rate-trend
openapi: 3.0.0
info:
  title: SIMULATOR OPENAPI REST-ful-API Reference
  version: 2025.20.0
  description: >

    ### Introduction

    This is the [OpenAPI 3.0](https://swagger.io/specification/) documentation

    of the
    [REST](https://en.wikipedia.org/wiki/Representational_state_transfer)-ful
    SIMULATOR OPENAPI API.


    ### Cross-Origin Resource Sharing

    This API features Cross-Origin Resource Sharing (CORS) implemented in

    compliance with [W3C spec](https://www.w3.org/TR/cors/), which allows

    cross-domain communication from the browser. All responses have a wildcard

    same-origin header which makes the API completely accessible.


    ### Authentication

    SIMULATOR OPENAPI offers following forms of authentication:

    - Bearer Token (JWT)

    - API Key


    ### Error Handling

    This API uses HTTP status codes equal or above 400 to indicate errors. Error

    details are generated in compliance with [RFC 7807 - "Problem Details for
    HTTP APIs"](https://tools.ietf.org/html/rfc7807).


    Every error response contains a traceId, which should be provided to the
    SIMULATOR OPENAPI Technical Support when reporting an error.
  contact:
    name: Cognigy Technical Support
    url: https://www.cognigy.com
    email: support@cognigy.com
  license:
    name: Cognigy Proprietary License
servers:
  - url: https://api-trial.cognigy.ai/testing
    description: Cognigy Service Testing API
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - name: Simulations
    description: >-
      Simulation management operations - Create, read, update, and delete
      simulations
externalDocs:
  description: SIMULATOR OPENAPI Documentation
  url: https://docs.cognigy.com/docs/service-testing/
paths:
  /dashboard/success-rate-trend:
    get:
      tags:
        - Dashboard
      summary: Get success rate trend data
      description: >-
        Retrieve 7-day rolling average trend of simulation outcomes for
        visualization. Returns daily aggregated data showing successful vs
        failed runs.
      operationId: getDashboardSuccessRateTrend
      parameters:
        - name: projectId
          in: query
          required: true
          schema:
            type: string
          description: Project identifier
        - name: scenarioIds
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
          style: form
          explode: false
          description: >-
            Filter by scenario/simulation reference IDs (comma-separated or
            array). If not provided, includes all scenarios.
          example:
            - sim-ref-1
            - sim-ref-2
        - name: timeWindow
          in: query
          required: false
          schema:
            type: string
            enum:
              - 7d
              - 30d
              - 3m
            default: 7d
          description: >-
            Time window for data aggregation. Options: 7d (last 7 days), 30d
            (last 30 days), 3m (last 3 months)
      responses:
        '200':
          description: Success rate trend data retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Array of daily trend data points
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          format: date
                          description: Date for this data point (YYYY-MM-DD)
                          example: '2024-01-15'
                        totalRuns:
                          type: integer
                          description: Total number of simulation runs on this date
                          example: 25
                        successfulRuns:
                          type: integer
                          description: Number of successful runs on this date
                          example: 22
                        failedRuns:
                          type: integer
                          description: Number of failed runs on this date
                          example: 3
                        successPercentage:
                          type: number
                          format: float
                          minimum: 0
                          maximum: 100
                          description: >-
                            Percentage of successful runs (same as successRate,
                            for convenience)
                          example: 88
                      required:
                        - date
                        - totalRuns
                        - successfulRuns
                        - failedRuns
                        - successRate
                        - successPercentage
                required:
                  - data
        '400':
          description: Bad Request - Invalid input parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Validation error message
                  field:
                    type: string
                    description: Field that failed validation
                  code:
                    type: string
                    description: Validation error code
                  traceId:
                    type: string
                    description: Trace ID for debugging
                required:
                  - error
                  - field
        '401':
          description: Unauthorized - Invalid or missing authentication
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Unauthorized error message
                  code:
                    type: string
                    description: Unauthorized error code
                  traceId:
                    type: string
                    description: Trace ID for debugging
                required:
                  - error
        '403':
          description: Forbidden - Insufficient permissions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Forbidden error message
                  code:
                    type: string
                    description: Forbidden error code
                  traceId:
                    type: string
                    description: Trace ID for debugging
                required:
                  - error
        '500':
          description: Internal Server Error - Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  code:
                    type: string
                    description: Error code
                  traceId:
                    type: string
                    description: Trace ID for debugging
                required:
                  - error
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT Bearer Token for authentication
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````