---
title: "POST /list-billing-group-cost-reports"
method: POST
path: "/list-billing-group-cost-reports"
---

# POST /list-billing-group-cost-reports

`POST /list-billing-group-cost-reports`

A paginated call to retrieve a summary report of actual Amazon Web Services charges and the calculated Amazon Web Services charges based on the associated pricing plan of a billing group.

## Request body

- object
  - `BillingPeriod` string — The preferred billing period for your report.
  - `MaxResults` integer — The maximum number of reports to retrieve.
  - `NextToken` string — The pagination token that's used on subsequent calls to get reports.
  - `Filters` object — The filter used to retrieve specific <code>BillingGroupCostReportElements</code>.
    - `BillingGroupArns` BillingGroupArn[] — The list of Amazon Resource Names (ARNs) used to filter billing groups to retrieve reports.

## Response `200`

Success

- ListBillingGroupCostReportsOutput
  - `BillingGroupCostReports` BillingGroupCostReportElement[] — A list of <code>BillingGroupCostReportElement</code> retrieved.
    - `Arn` string — The Amazon Resource Name (ARN) of a billing group.
    - `AWSCost` string — The actual Amazon Web Services charges for the billing group.
    - `ProformaCost` string — The hypothetical Amazon Web Services charges based on the associated pricing plan of a billing group.
    - `Margin` string — The billing group margin.
    - `MarginPercentage` string — The percentage of billing group margin.
    - `Currency` string — The displayed currency.
  - `NextToken` string — The pagination token that's used on subsequent calls to get reports.

## Other responses

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

---

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