:doc:`PartnerCentralAccountAPI <../../partnercentral-account>` / Client / list_partners

*************
list_partners
*************



.. py:method:: PartnerCentralAccountAPI.Client.list_partners(**kwargs)

  

  Lists partner accounts in the catalog, providing a summary view of all partners.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/partnercentral-account-2025-04-04/ListPartners>`_  


  **Request Syntax**
  ::

    response = client.list_partners(
        Catalog='string',
        NextToken='string'
    )
    
  :type Catalog: string
  :param Catalog: **[REQUIRED]** 

    The catalog identifier to list partners from.

    

  
  :type NextToken: string
  :param NextToken: 

    The token for retrieving the next page of results in paginated responses.

    

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

    
    ::

      {
          'PartnerSummaryList': [
              {
                  'Catalog': 'string',
                  'Arn': 'string',
                  'Id': 'string',
                  'LegalName': 'string',
                  'CreatedAt': datetime(2015, 1, 1)
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **PartnerSummaryList** *(list) --* 

        A list of partner summaries including basic information about each partner account.

        
        

        - *(dict) --* 

          A summary view of a partner account containing basic information for listing purposes.

          
          

          - **Catalog** *(string) --* 

            The catalog identifier for the partner account.

            
          

          - **Arn** *(string) --* 

            The Amazon Resource Name (ARN) of the partner account.

            
          

          - **Id** *(string) --* 

            The unique identifier of the partner account.

            
          

          - **LegalName** *(string) --* 

            The legal name of the partner organization.

            
          

          - **CreatedAt** *(datetime) --* 

            The timestamp when the partner account was created.

            
      
    
      

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

        The token for retrieving the next page of results if more results are available.

        
  
  **Exceptions**
  
  *   :py:class:`PartnerCentralAccountAPI.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`PartnerCentralAccountAPI.Client.exceptions.ThrottlingException`

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

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

  