:doc:`SESV2 <../../sesv2>` / Client / list_contact_lists

******************
list_contact_lists
******************



.. py:method:: SESV2.Client.list_contact_lists(**kwargs)

  

  Lists all of the contact lists available.

   

  If your output includes a "NextToken" field with a string value, this indicates there may be additional contacts on the filtered list - regardless of the number of contacts returned.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/sesv2-2019-09-27/ListContactLists>`_  


  **Request Syntax**
  ::

    response = client.list_contact_lists(
        PageSize=123,
        NextToken='string'
    )
    
  :type PageSize: integer
  :param PageSize: 

    Maximum number of contact lists to return at once. Use this parameter to paginate results. If additional contact lists exist beyond the specified limit, the ``NextToken`` element is sent in the response. Use the ``NextToken`` value in subsequent requests to retrieve additional lists.

    

  
  :type NextToken: string
  :param NextToken: 

    A string token indicating that there might be additional contact lists available to be listed. Use the token provided in the Response to use in the subsequent call to ListContactLists with the same parameters to retrieve the next page of contact lists.

    

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

    
    ::

      {
          'ContactLists': [
              {
                  'ContactListName': 'string',
                  'LastUpdatedTimestamp': datetime(2015, 1, 1)
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ContactLists** *(list) --* 

        The available contact lists.

        
        

        - *(dict) --* 

          A list that contains contacts that have subscribed to a particular topic or topics.

          
          

          - **ContactListName** *(string) --* 

            The name of the contact list.

            
          

          - **LastUpdatedTimestamp** *(datetime) --* 

            A timestamp noting the last time the contact list was updated.

            
      
    
      

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

        A string token indicating that there might be additional contact lists available to be listed. Copy this token to a subsequent call to ``ListContactLists`` with the same parameters to retrieve the next page of contact lists.

        
  
  **Exceptions**
  
  *   :py:class:`SESV2.Client.exceptions.BadRequestException`

  
  *   :py:class:`SESV2.Client.exceptions.TooManyRequestsException`

  