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

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

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

Lists the billing views available for a given time period.

Every Amazon Web Services account has a unique `PRIMARY` billing view that represents the billing data available by default. Accounts that use Billing Conductor also have `BILLING_GROUP` billing views representing pro forma costs associated with each created billing group.

## Headers

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

## Request body

- ListBillingViewsRequest
  - `activeTimeRange` object — The time range for the billing views listed. <code>PRIMARY</code> billing view is always listed. <code>BILLING_GROUP</code> billing views are listed for time ranges when the associated billing group resource in Billing Conductor is active. The time range must be within one calendar month.
    - `activeAfterInclusive` string, date-time, required — The inclusive time range start date.
    - `activeBeforeInclusive` string, date-time, required — The inclusive time range end date.
  - `arns` BillingViewArn[] — The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.
  - `billingViewTypes` BillingViewType[] — The type of billing view.
  - `names` StringSearch[] — Filters the list of billing views by name. You can specify search criteria to match billing view names based on the search option provided.
    - `searchOption` 'STARTS_WITH', required — The type of search operation to perform on the string value. Determines how the search value is matched against the target field.
    - `searchValue` string, required — The string value to use in the search operation. This value is compared against the target field using the specified search option.
  - `ownerAccountId` string — The list of owners of the billing view.
  - `sourceAccountId` string — Filters the results to include only billing views that use the specified account as a source.
  - `maxResults` integer — The maximum number of billing views to retrieve. Default is 100.
  - `nextToken` string — The pagination token that is used on subsequent calls to list billing views.

## Response `200`

Success

- ListBillingViewsResponse
  - `billingViews` BillingViewListElement[], required — A list of <code>BillingViewListElement</code> retrieved.
    - `arn` string — The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.
    - `name` string, password — A list of names of the Billing view.
    - `description` string, password — The description of the billing view.
    - `ownerAccountId` string — The list of owners 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.
    - `billingViewType` 'PRIMARY' | 'BILLING_GROUP' | 'CUSTOM' | 'BILLING_TRANSFER' | 'BILLING_TRANSFER_SHOWBACK' — The type of billing view.
    - `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.
  - `nextToken` string — The pagination token to use on subsequent calls to list billing views.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — 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)