ListBillingGroupCostReports - AWS Billing Conductor


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

Request Syntax

POST /list-billing-group-cost-reports HTTP/1.1 Content-type: application/json { "BillingPeriod": "string", "Filters": { "BillingGroupArns": [ "string" ] }, "MaxResults": number, "NextToken": "string" }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.


The preferred billing period for your report.

Type: String

Pattern: \d{4}-(0?[1-9]|1[012])

Required: No


A ListBillingGroupCostReportsFilter to specify billing groups to retrieve reports from.

Type: ListBillingGroupCostReportsFilter object

Required: No


The maximum number of reports to retrieve.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No


The pagination token that's used on subsequent calls to get reports.

Type: String

Required: No

Response Syntax

HTTP/1.1 200 Content-type: application/json { "BillingGroupCostReports": [ { "Arn": "string", "AWSCost": "string", "Currency": "string", "Margin": "string", "MarginPercentage": "string", "ProformaCost": "string" } ], "NextToken": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


A list of BillingGroupCostReportElement retrieved.

Type: Array of BillingGroupCostReportElement objects


The pagination token that's used on subsequent calls to get reports.

Type: String


For information about the errors that are common to all actions, see Common Errors.


You do not have sufficient access to perform this action.

HTTP Status Code: 403


An unexpected error occurred while processing a request.

HTTP Status Code: 500


The request references a resource that doesn't exist.

HTTP Status Code: 404


The request was denied due to request throttling.

HTTP Status Code: 429


The input doesn't match with the constraints specified by AWS services.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: