:doc:`BillingConductor <../../billingconductor>` / Client / list_billing_group_cost_reports

*******************************
list_billing_group_cost_reports
*******************************



.. py:method:: BillingConductor.Client.list_billing_group_cost_reports(**kwargs)

  

  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.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/ListBillingGroupCostReports>`_  


  **Request Syntax**
  ::

    response = client.list_billing_group_cost_reports(
        BillingPeriod='string',
        MaxResults=123,
        NextToken='string',
        Filters={
            'BillingGroupArns': [
                'string',
            ]
        }
    )
    
  :type BillingPeriod: string
  :param BillingPeriod: 

    The preferred billing period for your report.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of reports to retrieve.

    

  
  :type NextToken: string
  :param NextToken: 

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

    

  
  :type Filters: dict
  :param Filters: 

    A ``ListBillingGroupCostReportsFilter`` to specify billing groups to retrieve reports from.

    

  
    - **BillingGroupArns** *(list) --* 

      The list of Amazon Resource Names (ARNs) used to filter billing groups to retrieve reports.

      

    
      - *(string) --* 

      
  
  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'BillingGroupCostReports': [
              {
                  'Arn': 'string',
                  'AWSCost': 'string',
                  'ProformaCost': 'string',
                  'Margin': 'string',
                  'MarginPercentage': 'string',
                  'Currency': 'string'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **BillingGroupCostReports** *(list) --* 

        A list of ``BillingGroupCostReportElement`` retrieved.

        
        

        - *(dict) --* 

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

          
          

          - **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.

        
  
  **Exceptions**
  
  *   :py:class:`BillingConductor.Client.exceptions.ThrottlingException`

  
  *   :py:class:`BillingConductor.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`BillingConductor.Client.exceptions.ValidationException`

  
  *   :py:class:`BillingConductor.Client.exceptions.InternalServerException`

  
  *   :py:class:`BillingConductor.Client.exceptions.ResourceNotFoundException`

  