---
title: "POST /#X-Amz-Target=AWSBilling.GetBillingView"
method: POST
path: "/#X-Amz-Target=AWSBilling.GetBillingView"
---

# POST /#X-Amz-Target=AWSBilling.GetBillingView

`POST /#X-Amz-Target=AWSBilling.GetBillingView`

Returns the metadata associated to the specified billing view ARN.

## Headers

- `X-Amz-Target` 'AWSBilling.GetBillingView', required

## Request body

- GetBillingViewRequest
  - `arn` string, required — The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.

## Response `200`

Success

- GetBillingViewResponse
  - `billingView` object, required — The billing view element associated with the specified ARN.
    - `arn` string — The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.
    - `name` string, password — The account name of the billing view.
    - `description` string, password — The description of the billing view.
    - `billingViewType` 'PRIMARY' | 'BILLING_GROUP' | 'CUSTOM' | 'BILLING_TRANSFER' | 'BILLING_TRANSFER_SHOWBACK' — The type of billing group.
    - `ownerAccountId` string — The account owner of the billing view.
    - `sourceAccountId` string — The Amazon Web Services account ID that owns the source billing view, if this is a derived billing view.
    - `dataFilterExpression` object — See <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_billing_Expression.html">Expression</a>. Billing view only supports <code>LINKED_ACCOUNT</code>, <code>Tags</code>, and <code>CostCategories</code>.
      - `dimensions` object — The specific <code>Dimension</code> to use for <code>Expression</code>.
        - `key` 'LINKED_ACCOUNT', required — The names of the metadata types that you can use to filter and group your results.
        - `values` Value[], required — The metadata values that you can use to filter and group your results.
      - `tags` object — The specific <code>Tag</code> to use for <code>Expression</code>.
        - `key` string, required — The key for the tag.
        - `values` Value[], required — The specific value of the tag.
      - `costCategories` object — The filter that's based on <code>CostCategory</code> values.
        - `key` string, required — The unique name of the Cost Category.
        - `values` Value[], required — The specific value of the Cost Category.
      - `timeRange` object — Specifies a time range filter for the billing view data.
        - `beginDateInclusive` string, date-time — The inclusive start date of the time range.
        - `endDateInclusive` string, date-time — The inclusive end date of the time range.
    - `createdAt` string, date-time — The time when the billing view was created.
    - `updatedAt` string, date-time — The time when the billing view was last updated.
    - `derivedViewCount` integer — The number of billing views that use this billing view as a source.
    - `sourceViewCount` integer — The number of source views associated with this billing view.
    - `viewDefinitionLastUpdatedAt` string, date-time — The timestamp of when the billing view definition was last updated.
    - `healthStatus` object — The current health status of the billing view.
      - `statusCode` 'HEALTHY' | 'UNHEALTHY' | 'CREATING' | 'UPDATING' — The current health status code of the billing view.
      - `statusReasons` BillingViewStatusReason[] — A list of reasons explaining the current health status, if applicable.

## Other responses

- `480` — ThrottlingException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ValidationException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/billing.md) · [All operations](https://skmtc.net/aws/apis/billing/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/billing/versions/41b2ba3c3d6f/schema)