Azure Cost Management Views API

openapi: 3.2.0
info:
  title: CostManagementClient Views API
  version: '2026-06-01'
  description: CostManagement management client provides access to CostManagement resources for Azure Enterprise Subscriptions.
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Views
paths:
  /providers/Microsoft.CostManagement/views:
    get:
      operationId: Views_List
      tags:
      - Views
      description: Lists all views by tenant and object.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/costmanagement/
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ViewListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        PrivateViewList:
          $ref: ./examples/PrivateViewList.json
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Views list
      x-summary-source: derived
  /providers/Microsoft.CostManagement/views/{viewName}:
    get:
      operationId: Views_Get
      tags:
      - Views
      description: Gets the view by view name.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/costmanagement/
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - name: viewName
        in: path
        description: View name
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/View'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        PrivateView:
          $ref: ./examples/PrivateView.json
      summary: Views get
      x-summary-source: derived
    put:
      operationId: Views_CreateOrUpdate
      tags:
      - Views
      description: The operation to create or update a view. Update operation requires latest eTag to be set in the request. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/costmanagement/
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - name: viewName
        in: path
        description: View name
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource 'View' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/View'
        '201':
          description: Resource 'View' create operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/View'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        CreateOrUpdatePrivateView:
          $ref: ./examples/PrivateViewCreateOrUpdate.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/View'
        description: Parameters supplied to the CreateOrUpdate View operation.
        required: true
      summary: Views create or update
      x-summary-source: derived
    delete:
      operationId: Views_Delete
      tags:
      - Views
      description: The operation to delete a view.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/costmanagement/
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - name: viewName
        in: path
        description: View name
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource deleted successfully.
        '204':
          description: Resource does not exist.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        DeletePrivateView:
          $ref: ./examples/PrivateViewDelete.json
      summary: Views delete
      x-summary-source: derived
components:
  schemas:
    AccumulatedType:
      type: string
      description: Show costs accumulated over time.
      enum:
      - 'true'
      - 'false'
      x-ms-enum:
        name: AccumulatedType
        modelAsString: true
        values:
        - name: 'true'
          value: 'true'
        - name: 'false'
          value: 'false'
    KpiProperties:
      type: object
      description: Each KPI must contain a 'type' and 'enabled' key.
      properties:
        type:
          $ref: '#/components/schemas/KpiTypeType'
          description: KPI type (Forecast, Budget).
        id:
          type: string
          description: ID of resource related to metric (budget).
        enabled:
          type: boolean
          description: show the KPI in the UI?
    ReportConfigFilter:
      type: object
      description: The filter expression to be used in the report.
      properties:
        and:
          type: array
          description: The logical "AND" expression. Must have at least 2 items.
          minItems: 2
          items:
            $ref: '#/components/schemas/ReportConfigFilter'
          x-ms-identifiers: []
        or:
          type: array
          description: The logical "OR" expression. Must have at least 2 items.
          minItems: 2
          items:
            $ref: '#/components/schemas/ReportConfigFilter'
          x-ms-identifiers: []
        dimensions:
          $ref: '#/components/schemas/ReportConfigComparisonExpression'
          description: Has comparison expression for a dimension
        tags:
          $ref: '#/components/schemas/ReportConfigComparisonExpression'
          description: Has comparison expression for a tag
    ReportConfigComparisonExpression:
      type: object
      description: The comparison expression to be used in the report.
      properties:
        name:
          type: string
          description: The name of the column to use in comparison.
        operator:
          $ref: '#/components/schemas/OperatorType'
          description: The operator to use for comparison.
        values:
          type: array
          description: Array of values to use for comparison
          minItems: 1
          items:
            type: string
      required:
      - name
      - operator
      - values
    ReportType:
      type: string
      description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates.
      enum:
      - Usage
      x-ms-enum:
        name: ReportType
        modelAsString: true
        values:
        - name: Usage
          value: Usage
    KpiTypeType:
      type: string
      description: KPI type (Forecast, Budget).
      enum:
      - Forecast
      - Budget
      x-ms-enum:
        name: KpiTypeType
        modelAsString: true
        values:
        - name: Forecast
          value: Forecast
        - name: Budget
          value: Budget
    ReportConfigTimePeriod:
      type: object
      description: The start and end date for pulling data for the report.
      properties:
        from:
          type: string
          format: date-time
          description: The start date to pull data from.
        to:
          type: string
          format: date-time
          description: The end date to pull data to.
      required:
      - from
      - to
    ReportConfigAggregation:
      type: object
      description: The aggregation expression to be used in the report.
      properties:
        name:
          type: string
          description: The name of the column to aggregate.
        function:
          $ref: '#/components/schemas/FunctionType'
          description: The name of the aggregation function to use.
      required:
      - name
      - function
    ReportConfigDatasetConfiguration:
      type: object
      description: The configuration of dataset in the report.
      properties:
        columns:
          type: array
          description: Array of column names to be included in the report. Any valid report column name is allowed. If not provided, then report includes all columns.
          items:
            type: string
    View:
      type: object
      description: States and configurations of Cost Analysis.
      properties:
        properties:
          $ref: '#/components/schemas/ViewProperties'
          description: The properties of the view.
          x-ms-client-flatten: true
        eTag:
          $ref: '#/components/schemas/Azure.Core.eTag'
          description: eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.
      allOf:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/definitions/ProxyResource
    ReportConfigDefinition:
      type: object
      description: The definition of a report config.
      properties:
        type:
          $ref: '#/components/schemas/ReportType'
          description: The type of the report. Usage represents actual usage, forecast represents forecasted data and UsageAndForecast represents both usage and forecasted data. Actual usage and forecasted data can be differentiated based on dates.
        timeframe:
          $ref: '#/components/schemas/ReportTimeframeType'
          description: The time frame for pulling data for the report. If custom, then a specific time period must be provided.
        timePeriod:
          $ref: '#/components/schemas/ReportConfigTimePeriod'
          description: Has time period for pulling data for the report.
        dataSet:
          $ref: '#/components/schemas/ReportConfigDataset'
          description: Has definition for data in this report config.
        includeMonetaryCommitment:
          type: boolean
          description: If true, report includes monetary commitment.
      required:
      - type
      - timeframe
    OperatorType:
      type: string
      description: The operator to use for comparison.
      enum:
      - In
      - Contains
      x-ms-enum:
        name: OperatorType
        modelAsString: true
        values:
        - name: In
          value: In
        - name: Contains
          value: Contains
    ErrorDetails:
      type: object
      description: The details of the error.
      properties:
        code:
          type: string
          description: Error code.
          readOnly: true
        message:
          type: string
          description: Error message indicating why the operation failed.
          readOnly: true
    ReportConfigSortingType:
      type: string
      description: Direction of sort.
      enum:
      - Ascending
      - Descending
      x-ms-enum:
        name: ReportConfigSortingType
        modelAsString: true
        values:
        - name: Ascending
          value: Ascending
        - name: Descending
          value: Descending
    MetricType:
      type: string
      description: Metric to use when displaying costs.
      enum:
      - ActualCost
      - AmortizedCost
      - AHUB
      x-ms-enum:
        name: MetricType
        modelAsString: true
        values:
        - name: ActualCost
          value: ActualCost
        - name: AmortizedCost
          value: AmortizedCost
        - name: AHUB
          value: AHUB
    ViewListResult:
      type: object
      description: Result of listing views. It contains a list of available views.
      properties:
        value:
          type: array
          description: The list of views.
          items:
            $ref: '#/components/schemas/View'
          readOnly: true
        nextLink:
          type: string
          description: The link (url) to the next page of results.
    ChartType:
      type: string
      description: Chart type of the main view in Cost Analysis. Required.
      enum:
      - Area
      - Line
      - StackedColumn
      - GroupedColumn
      - Table
      x-ms-enum:
        name: ChartType
        modelAsString: true
        values:
        - name: Area
          value: Area
        - name: Line
          value: Line
        - name: StackedColumn
          value: StackedColumn
        - name: GroupedColumn
          value: GroupedColumn
        - name: Table
          value: Table
    FunctionType:
      type: string
      description: The name of the aggregation function to use.
      enum:
      - Sum
      x-ms-enum:
        name: FunctionType
        modelAsString: true
        values:
        - name: Sum
          value: Sum
    ReportConfigGrouping:
      type: object
      description: The group by expression to be used in the report.
      properties:
        type:
          $ref: '#/components/schemas/QueryColumnType'
          description: Has type of the column to group.
        name:
          type: string
          description: The name of the column to group. This version supports subscription lowest possible grain.
      required:
      - type
      - name
    ReportGranularityType:
      type: string
      description: The granularity of rows in the report.
      enum:
      - Daily
      - Monthly
      x-ms-enum:
        name: ReportGranularityType
        modelAsString: true
        values:
        - name: Daily
          value: Daily
        - name: Monthly
          value: Monthly
    PivotTypeType:
      type: string
      description: Data type to show in view.
      enum:
      - Dimension
      - TagKey
      x-ms-enum:
        name: PivotTypeType
        modelAsString: true
        values:
        - name: Dimension
          value: Dimension
        - name: TagKey
          value: TagKey
    Azure.Core.eTag:
      type: string
      description: 'The ETag (or entity tag) HTTP response header is an identifier for a specific version of a resource.

        It lets caches be more efficient and save bandwidth, as a web server does not need to resend a full response if the content was not changed.


        It is a string of ASCII characters placed between double quotes, like "675af34563dc-tr34".'
    ReportTimeframeType:
      type: string
      description: The time frame for pulling data for the report. If custom, then a specific time period must be provided.
      enum:
      - WeekToDate
      - MonthToDate
      - YearToDate
      - Custom
      x-ms-enum:
        name: ReportTimeframeType
        modelAsString: true
        values:
        - name: WeekToDate
          value: WeekToDate
        - name: MonthToDate
          value: MonthToDate
        - name: YearToDate
          value: YearToDate
        - name: Custom
          value: Custom
    ReportConfigSorting:
      type: object
      description: The order by expression to be used in the report.
      properties:
        direction:
          $ref: '#/components/schemas/ReportConfigSortingType'
          description: Direction of sort.
        name:
          type: string
          description: The name of the column to sort.
      required:
      - name
    ViewProperties:
      type: object
      description: The properties of the view.
      properties:
        displayName:
          type: string
          description: User input name of the view. Required.
        scope:
          type: string
          description: Cost Management scope to save the view on. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope, '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for ExternalBillingAccount scope, and '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for ExternalSubscription scope.
        createdOn:
          type: string
          format: date-time
          description: Date the user created this view.
          readOnly: true
        modifiedOn:
          type: string
          format: date-time
          description: Date when the user last modified this view.
        dateRange:
          type: string
          description: Date range of the current view.
        currency:
          type: string
          description: Currency of the current view.
          readOnly: true
        query:
          $ref: '#/components/schemas/ReportConfigDefinition'
          description: Query body configuration. Required.
          x-ms-client-flatten: true
        chart:
          $ref: '#/components/schemas/ChartType'
          description: Chart type of the main view in Cost Analysis. Required.
        accumulated:
          $ref: '#/components/schemas/AccumulatedType'
          description: Show costs accumulated over time.
        metric:
          $ref: '#/components/schemas/MetricType'
          description: Metric to use when displaying costs.
        kpis:
          type: array
          description: List of KPIs to show in Cost Analysis UI.
          items:
            $ref: '#/components/schemas/KpiProperties'
        pivots:
          type: array
          description: Configuration of 3 sub-views in the Cost Analysis UI.
          items:
            $ref: '#/components/schemas/PivotProperties'
          x-ms-identifiers:
          - name
    QueryColumnType:
      type: string
      description: The type of the column in the report.
      enum:
      - TagKey
      - Dimension
      x-ms-enum:
        name: QueryColumnType
        modelAsString: true
        values:
        - name: TagKey
          value: TagKey
          description: The tag associated with the cost data.
        - name: Dimension
          value: Dimension
          description: The dimension of cost data.
    ReportConfigDataset:
      type: object
      description: The definition of data present in the report.
      properties:
        granularity:
          $ref: '#/components/schemas/ReportGranularityType'
          description: The granularity of rows in the report.
        configuration:
          $ref: '#/components/schemas/ReportConfigDatasetConfiguration'
          description: Has configuration information for the data in the report. The configuration will be ignored if aggregation and grouping are provided.
        aggregation:
          type: object
          description: Dictionary of aggregation expression to use in the report. The key of each item in the dictionary is the alias for the aggregated column. Report can have up to 2 aggregation clauses.
          additionalProperties:
            $ref: '#/components/schemas/ReportConfigAggregation'
        grouping:
          type: array
          description: Array of group by expression to use in the report. Report can have up to 2 group by clauses.
          maxItems: 2
          items:
            $ref: '#/components/schemas/ReportConfigGrouping'
          x-ms-identifiers:
          - name
          - type
        sorting:
          type: array
          description: Array of order by expression to use in the report.
          items:
            $ref: '#/components/schemas/ReportConfigSorting'
          x-ms-identifiers: []
        filter:
          $ref: '#/components/schemas/ReportConfigFilter'
          description: Has filter expression to use in the report.
    PivotProperties:
      type: object
      description: Each pivot must contain a 'type' and 'name'.
      properties:
        type:
          $ref: '#/components/schemas/PivotTypeType'
          description: Data type to show in view.
        name:
          type: string
          description: Data field to show in view.
    ErrorResponse:
      type: object
      description: 'Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message. \n\nSome Error responses: \n\n * 429 TooManyRequests - Request is throttled. Retry after waiting for the time specified in the \"x-ms-ratelimit-microsoft.consumption-retry-after\" header. \n\n * 503 ServiceUnavailable - Service is temporarily unavailable. Retry after waiting for the time specified in the \"Retry-After\" header.'
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetails'
          description: The details of the error.
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.