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

# List saved views for a report definition.

> Returns the saved views the current caller can list for the specified definition, ordered by view name.
Each item indicates whether the caller can update or share it. This operation does not return report-run
rows or launch a report.



## OpenAPI

````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json get /api/ReportQuery/Views/{reportDefinitionId}
openapi: 3.0.4
info:
  title: Derivitec Api 1.0
  version: '1.0'
servers:
  - url: https://api.riskportal.activeviam.com
security:
  - oauth2: []
  - apikey: []
tags:
  - name: AdminUser
  - name: AtotiReport
  - name: AtotiSession
  - name: BloombergOAuth
  - name: Bond
  - name: BondYieldCurvePage
  - name: BookAccess
  - name: Books
  - name: Commodity
  - name: Counterparties
  - name: Currencies
  - name: Equity
  - name: EquityDividend
  - name: EquityPage
  - name: FeatureFlag
  - name: Fx
  - name: FxPage
  - name: GroupAccess
  - name: Home
  - name: LegacyPosition
  - name: MarketData
  - name: MarketDataProvider
  - name: MarketDataProviderAccess
  - name: Meta
  - name: Notification
  - name: Organisation
  - name: PnLReport
  - name: PortfolioAccess
  - name: Portfolios
  - name: Position
  - name: PositionFilter
  - name: PricingEnvironment
  - name: PricingEnvironmentAccess
  - name: RateAsset
  - name: RateAssetPage
  - name: Report
  - name: ReportDefinition
  - name: ReportHistoryLauncherQuery
  - name: ReportLauncher
  - name: ReportQuery
  - name: ReportQueryViewUser
  - name: ReportRestriction
  - name: ReportView
  - name: RiskReport
  - name: Tradable
  - name: TradeBooking
  - name: User
  - name: VarReport
  - name: VarReportQuery
  - name: YieldCurvePage
paths:
  /api/ReportQuery/Views/{reportDefinitionId}:
    get:
      tags:
        - ReportQuery
      summary: List saved views for a report definition.
      description: >-
        Returns the saved views the current caller can list for the specified
        definition, ordered by view name.

        Each item indicates whether the caller can update or share it. This
        operation does not return report-run

        rows or launch a report.
      operationId: ListReportViews
      parameters:
        - name: reportDefinitionId
          in: path
          description: >-
            The opaque report-definition identifier whose saved views are
            requested; this is not a report-run identifier.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            Returns the accessible saved views and their update and sharing
            indicators, with business or access failures in the response
            envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListReportViewsResponse'
        '400':
          description: BadRequest
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
        - oauth2: []
        - apikey: []
components:
  schemas:
    ListReportViewsResponse:
      required:
        - $type
      type: object
      properties:
        views:
          type: array
          items:
            $ref: '#/components/schemas/ReportView'
          description: >-
            Saved report views available to the caller for the selected report
            definition.
          nullable: true
        is_success:
          type: boolean
          description: >-
            Whether the operation completed successfully. The default is `true`;
            error outcomes set it to `false`.
          example: true
        error_messages:
          type: array
          items:
            type: string
          description: >-
            Messages explaining operation-level failures. The collection is
            empty by default.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Core.Mediators.ReportView.ListReportViewsResponse,
              Derivitec.Core.Mediators
      additionalProperties: false
      description: >-
        Response containing saved report views available for a report
        definition.
    ReportView:
      required:
        - $type
      type: object
      properties:
        id:
          type: string
          description: Opaque identifier for the saved view.
          nullable: true
        report_definition_id:
          type: string
          description: Opaque identifier of the saved view's report definition.
          nullable: true
        payload:
          type: string
          description: >-
            Client-supplied saved-view payload; its internal format is not
            established by this contract.
          nullable: true
        name:
          type: string
          description: Name of the saved view.
          nullable: true
          example: |2-

                        Example saved view
                        
        include_in_scheduled_export:
          type: boolean
          description: >-
            Nullable flag that records whether the saved view is included in
            scheduled export.
          nullable: true
          example: false
        can_update:
          type: boolean
          description: Whether the caller may update this saved view.
        can_share:
          type: boolean
          description: Whether the caller may change sharing for this saved view.
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.Reports.ReportView, Derivitec.Web.Core
      additionalProperties: false
      description: Saved view associated with a report definition.
  securitySchemes:
    oauth2:
      type: oauth2
      description: >-
        OAuth2 access-token requested from AWS Cognito and provided as a Auth
        Bearer header
      flows:
        implicit:
          authorizationUrl: https://auth.riskportal.derivitec.com/oauth2/authorize
          scopes: {}
    apikey:
      type: apiKey
      description: API-Key requested via the site and provided as a header
      name: x-api-key
      in: header

````