> ## 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.

# Retrieve paged VaR group tables.

> A valid non-negative `TableIndex` selects one available group table; other values return all
available tables. A `PageSize` of `-1` uses the report's configured take value. No additional
positive range or result-ordering guarantee is declared.



## OpenAPI

````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/VarReportQuery/GroupVarTables
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/VarReportQuery/GroupVarTables:
    post:
      tags:
        - VarReportQuery
      summary: Retrieve paged VaR group tables.
      description: >-
        A valid non-negative `TableIndex` selects one available group table;
        other values return all

        available tables. A `PageSize` of `-1` uses the report's configured take
        value. No additional

        positive range or result-ordering guarantee is declared.
      operationId: GroupVarTables
      requestBody:
        description: >-
          The body containing the opaque `ReportId`, optional VaR selection
          fields, `TableIndex` (default `-1`), `Page` (default `1`), and
          `PageSize` (default `-1`).
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ApiVarReportQueryGroupVarTablesRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ApiVarReportQueryGroupVarTablesRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ApiVarReportQueryGroupVarTablesRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ApiVarReportQueryGroupVarTablesRequest'
      responses:
        '200':
          description: Returns the selected page of one or all available VaR group tables.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiVarReportQueryGroupVarTablesResponse'
        '400':
          description: BadRequest
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
        - oauth2: []
        - apikey: []
components:
  schemas:
    ApiVarReportQueryGroupVarTablesRequest:
      required:
        - $type
      type: object
      properties:
        confidence_level:
          type: number
          description: >-
            Optional VaR confidence-level override expressed as a decimal
            fraction; null retains the report's configured level.
          format: double
          nullable: true
          example: 0.99
        row_query:
          $ref: '#/components/schemas/FilterBase'
        weighting_var_definition:
          $ref: '#/components/schemas/WeightingVarDefinition'
        row_restriction_filter:
          $ref: '#/components/schemas/FilterBase'
        full_report_filter:
          $ref: '#/components/schemas/MultiFilter'
        report_configuration:
          $ref: '#/components/schemas/VarReportConfiguration'
        report_id:
          type: string
          description: >-
            Opaque identifier of the report run to retrieve or query. The value
            must not be null or empty.
          nullable: true
        portfolio_type:
          enum:
            - derivitec
            - enfusion
            - orchestrade
            - liquidity_book
            - maia
            - fund_studio
            - not_set
          type: string
          description: >-
            Portfolio category used to resolve the requested portfolio. It may
            be omitted when the portfolio name resolves unambiguously.
          nullable: true
        table_index:
          type: integer
          description: >-
            Zero-based configured table index to select; `-1` requests all
            tables and is the default.
          format: int32
          example: -1
        page:
          type: integer
          description: One-based page number to return; defaults to `1`.
          format: int32
          example: 1
        page_size:
          type: integer
          description: >-
            Number of rows requested per table; `-1` uses each table
            definition's `take_n` value and is the default.
          format: int32
          example: -1
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.VarReportQuery.ApiVarReportQueryGroupVarTablesRequest,
              Derivitec.Web.Core
      additionalProperties: false
      description: Requests paged group VaR tables for a report.
    ApiVarReportQueryGroupVarTablesResponse:
      required:
        - $type
      type: object
      properties:
        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
        price_histories_count:
          type: integer
          description: Number of position price histories used to produce the query result.
          format: int32
        group_var_tables:
          type: array
          items:
            $ref: '#/components/schemas/GroupVarTable'
          description: >-
            Selected group VaR tables with page metadata and display
            definitions.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.VarReportQuery.ApiVarReportQueryGroupVarTablesResponse,
              Derivitec.Web.Core
      additionalProperties: false
      description: Returns paged group VaR tables and their display definitions.
    FilterBase:
      description: Base selection criterion for a named report-data field.
      discriminator:
        propertyName: $type
        mapping:
          Derivitec.Web.Core.Filters.Filter, Derivitec.Web.Core: '#/components/schemas/FilterMintlifyShape'
          Derivitec.Web.Core.Filters.FilterBase, Derivitec.Web.Core: '#/components/schemas/FilterBaseMintlifyShape'
          Derivitec.Web.Core.Filters.MultiFilter, Derivitec.Web.Core: '#/components/schemas/MultiFilter'
          Derivitec.Web.Core.Filters.StringFilter, Derivitec.Web.Core: '#/components/schemas/StringFilter'
      oneOf:
        - $ref: '#/components/schemas/FilterMintlifyShape'
        - $ref: '#/components/schemas/FilterBaseMintlifyShape'
        - $ref: '#/components/schemas/MultiFilter'
        - $ref: '#/components/schemas/StringFilter'
    WeightingVarDefinition:
      required:
        - $type
      type: object
      properties:
        active:
          type: boolean
          description: Whether the VaR weighting configuration is enabled.
        window_length:
          type: integer
          description: Window-length value; no unit is established here.
          format: int32
        decay_period:
          type: integer
          description: Decay-period value; no unit is established here.
          format: int32
        scheme:
          enum:
            - exponentially_weighted
            - filtered_historical
          type: string
          description: Weighting scheme selected for the historical VaR configuration.
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.Reports.WeightingVarDefinition,
              Derivitec.Web.Core
      additionalProperties: false
      description: Configuration used to select VaR weighting behaviour.
    MultiFilter:
      required:
        - $type
      type: object
      properties:
        field:
          type: string
          description: Name of the report-data field evaluated by this criterion.
          nullable: true
        operator:
          enum:
            - not_set
            - and
            - or
          type: string
          description: Logical rule used to combine the child criteria.
        conditions:
          type: array
          items:
            $ref: '#/components/schemas/FilterBase'
          description: >-
            Child criteria evaluated by the selected logical operator; nested
            groups are permitted.
          nullable: true
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.Filters.MultiFilter, Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Nested filter group that combines child criteria with a logical
        operator.
    VarReportConfiguration:
      required:
        - $type
      type: object
      properties:
        name:
          type: string
          description: Display name for this report-query or export configuration.
          nullable: true
          example: Default
        row_query:
          $ref: '#/components/schemas/FilterBase'
        confidence_level:
          type: number
          description: >-
            Optional VaR confidence-level override expressed as a decimal
            fraction; null retains the report's configured level.
          format: double
          nullable: true
          example: 0.99
        weighting_var_definition:
          $ref: '#/components/schemas/WeightingVarDefinition'
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.VarReportConfiguration, Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Optional named overrides used when querying or exporting a historical
        VaR report.
    GroupVarTable:
      required:
        - $type
      type: object
      properties:
        data_table:
          description: Rows and columns for the requested page of grouped VaR results.
          nullable: true
        table_definition:
          $ref: '#/components/schemas/GroupVarTableDefinition'
        last_row:
          type: integer
          description: Total number of rows in the complete grouped table before paging.
          format: int32
        page:
          type: integer
          description: One-based page number represented by `data_table`.
          format: int32
        page_size:
          type: integer
          description: Effective number of rows requested for this page.
          format: int32
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.VarReportQuery.GroupVarTable,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Contains one page of grouped VaR rows and the metadata needed to present
        them.
    FilterMintlifyShape:
      required:
        - $type
      type: object
      properties:
        field:
          type: string
          description: Name of the report-data field evaluated by this criterion.
          nullable: true
        type:
          type: string
          nullable: true
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.Filters.Filter, Derivitec.Web.Core
      additionalProperties: false
    FilterBaseMintlifyShape:
      required:
        - $type
      type: object
      properties:
        field:
          type: string
          description: Name of the report-data field evaluated by this criterion.
          nullable: true
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.Filters.FilterBase, Derivitec.Web.Core
      additionalProperties: false
      description: Base selection criterion for a named report-data field.
    StringFilter:
      required:
        - $type
      type: object
      properties:
        field:
          type: string
          description: Name of the report-data field evaluated by this criterion.
          nullable: true
        type:
          type: string
          nullable: true
        filter:
          type: string
          nullable: true
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.Filters.StringFilter, Derivitec.Web.Core
      additionalProperties: false
    GroupVarTableDefinition:
      required:
        - $type
      type: object
      properties:
        columns:
          type: array
          items:
            $ref: '#/components/schemas/VuetifyDataTableColumns'
          description: >-
            Display metadata for table columns other than the VaR-statistics
            columns.
          nullable: true
        columns_scaled_by_aum:
          uniqueItems: true
          type: array
          items:
            type: string
          description: >-
            Internal column names whose displayed values are scaled by assets
            under management.
          nullable: true
        group_by_properties:
          type: array
          items:
            type: string
          description: Position property names used to group the table rows.
          nullable: true
        sort_column:
          type: string
          description: Internal column name used to sort the complete table.
          nullable: true
        sort_direction:
          enum:
            - ascending
            - descending
          type: string
          description: Direction in which `sort_column` is sorted.
        take_n:
          type: integer
          description: >-
            Number of sorted rows retained by the table definition and used as
            the default page size.
          format: int32
        title:
          type: string
          description: Human-readable table title.
          nullable: true
        infinite_scroll:
          type: boolean
          description: >-
            Whether the report definition marks this table for infinite-scroll
            presentation.
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.VarReportQuery.GroupVarTableDefinition,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Describes the grouping, sorting, columns, and presentation of a group
        VaR table.
    VuetifyDataTableColumns:
      required:
        - $type
      type: object
      properties:
        value:
          type: string
          description: Internal column name used to read values from returned rows.
          nullable: true
        title:
          type: string
          description: Human-readable column heading.
          nullable: true
        multiplier:
          type: number
          description: >-
            Display multiplier applied to column values; defaults to `1` when no
            multiplier is configured.
          format: double
          example: 1
        col_type:
          type: string
          description: Client column-type label associated with the source column.
          nullable: true
        visible:
          type: boolean
          description: Whether the column is marked visible in the report definition.
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.VarReportQuery.VuetifyDataTableColumns,
              Derivitec.Web.Core
      additionalProperties: false
      description: Describes how a group VaR table column is labelled and displayed.
  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

````