:doc:`Route53Domains <../../route53domains>` / Client / view_billing

************
view_billing
************



.. py:method:: Route53Domains.Client.view_billing(**kwargs)

  

  Returns all the domain-related billing records for the current Amazon Web Services account for a specified period

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ViewBilling>`_  


  **Request Syntax**
  ::

    response = client.view_billing(
        Start=datetime(2015, 1, 1),
        End=datetime(2015, 1, 1),
        Marker='string',
        MaxItems=123
    )
    
  :type Start: datetime
  :param Start: 

    The beginning date and time for the time period for which you want a list of billing records. Specify the date and time in Unix time format and Coordinated Universal time (UTC).

    

  
  :type End: datetime
  :param End: 

    The end date and time for the time period for which you want a list of billing records. Specify the date and time in Unix time format and Coordinated Universal time (UTC).

    

  
  :type Marker: string
  :param Marker: 

    For an initial request for a list of billing records, omit this element. If the number of billing records that are associated with the current Amazon Web Services account during the specified period is greater than the value that you specified for ``MaxItems``, you can use ``Marker`` to return additional billing records. Get the value of ``NextPageMarker`` from the previous response, and submit another request that includes the value of ``NextPageMarker`` in the ``Marker`` element.

     

    Constraints: The marker must match the value of ``NextPageMarker`` that was returned in the previous response.

    

  
  :type MaxItems: integer
  :param MaxItems: 

    The number of billing records to be returned.

     

    Default: 20

    

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

    
    ::

      {
          'NextPageMarker': 'string',
          'BillingRecords': [
              {
                  'DomainName': 'string',
                  'Operation': 'REGISTER_DOMAIN'|'DELETE_DOMAIN'|'TRANSFER_IN_DOMAIN'|'UPDATE_DOMAIN_CONTACT'|'UPDATE_NAMESERVER'|'CHANGE_PRIVACY_PROTECTION'|'DOMAIN_LOCK'|'ENABLE_AUTORENEW'|'DISABLE_AUTORENEW'|'ADD_DNSSEC'|'REMOVE_DNSSEC'|'EXPIRE_DOMAIN'|'TRANSFER_OUT_DOMAIN'|'CHANGE_DOMAIN_OWNER'|'RENEW_DOMAIN'|'PUSH_DOMAIN'|'INTERNAL_TRANSFER_OUT_DOMAIN'|'INTERNAL_TRANSFER_IN_DOMAIN'|'RELEASE_TO_GANDI'|'TRANSFER_ON_RENEW'|'RESTORE_DOMAIN',
                  'InvoiceId': 'string',
                  'BillDate': datetime(2015, 1, 1),
                  'Price': 123.0
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 

      The ViewBilling response includes the following elements.

      
      

      - **NextPageMarker** *(string) --* 

        If there are more billing records than you specified for ``MaxItems`` in the request, submit another request and include the value of ``NextPageMarker`` in the value of ``Marker``.

        
      

      - **BillingRecords** *(list) --* 

        A summary of billing records.

        
        

        - *(dict) --* 

          Information for one billing record.

          
          

          - **DomainName** *(string) --* 

            The name of the domain that the billing record applies to. If the domain name contains characters other than a-z, 0-9, and - (hyphen), such as an internationalized domain name, then this value is in Punycode. For more information, see `DNS Domain Name Format <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html>`__ in the *Amazon Route 53 Developer Guide*.

            
          

          - **Operation** *(string) --* 

            The operation that you were charged for.

            
          

          - **InvoiceId** *(string) --* 

            Deprecated property. This field is retained in report structure for backwards compatibility, but will appear blank.

            
          

          - **BillDate** *(datetime) --* 

            The date that the operation was billed, in Unix format.

            
          

          - **Price** *(float) --* 

            The price that you were charged for the operation, in US dollars.

             

            Example value: 12.0

            
      
    
  
  **Exceptions**
  
  *   :py:class:`Route53Domains.Client.exceptions.InvalidInput`

  