:doc:`Route53Domains <../../route53domains>` / Paginator / ViewBilling

***********
ViewBilling
***********



.. py:class:: Route53Domains.Paginator.ViewBilling

  ::

    
    paginator = client.get_paginator('view_billing')

  
  

  .. py:method:: paginate(**kwargs)

    Creates an iterator that will paginate through responses from :py:meth:`Route53Domains.Client.view_billing`.

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


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          Start=datetime(2015, 1, 1),
          End=datetime(2015, 1, 1),
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :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 PaginationConfig: dict
    :param PaginationConfig: 

      A dictionary that provides parameters to control pagination.

      

    
      - **MaxItems** *(integer) --* 

        The total number of items to return. If the total number of items available is more than the value specified in max-items then a ``NextToken`` will be provided in the output that you can use to resume pagination.

        

      
      - **PageSize** *(integer) --* 

        The size of each page.

        

      
      - **StartingToken** *(string) --* 

        A token to specify where to start paginating. This is the ``NextToken`` from a previous response.

        

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

      
      ::

        {
            '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
                },
            ],
            'NextToken': 'string'
        }
        
      **Response Structure**

      

      - *(dict) --* 

        The ViewBilling response includes the following elements.

        
        

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

              
        
      
        

        - **NextToken** *(string) --* 

          A token to resume pagination.

          
    