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

***************************
list_connection_invitations
***************************



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

  

  Lists connection invitations for the partner account, with optional filtering by status, type, and other criteria.

  

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


  **Request Syntax**
  ::

    response = client.list_connection_invitations(
        Catalog='string',
        NextToken='string',
        ConnectionType='OPPORTUNITY_COLLABORATION'|'SUBSIDIARY',
        MaxResults=123,
        OtherParticipantIdentifiers=[
            'string',
        ],
        ParticipantType='SENDER'|'RECEIVER',
        Status='PENDING'|'ACCEPTED'|'REJECTED'|'CANCELED'|'EXPIRED'
    )
    
  :type Catalog: string
  :param Catalog: **[REQUIRED]** 

    The catalog identifier for the partner account.

    

  
  :type NextToken: string
  :param NextToken: 

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

    

  
  :type ConnectionType: string
  :param ConnectionType: 

    Filter results by connection type (e.g., reseller, distributor, technology partner).

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of connection invitations to return in a single response.

    

  
  :type OtherParticipantIdentifiers: list
  :param OtherParticipantIdentifiers: 

    Filter results by specific participant identifiers.

    

  
    - *(string) --* 

    

  :type ParticipantType: string
  :param ParticipantType: 

    Filter results by participant type (inviter or invitee).

    

  
  :type Status: string
  :param Status: 

    Filter results by invitation status (pending, accepted, rejected, canceled, expired).

    

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

    
    ::

      {
          'ConnectionInvitationSummaries': [
              {
                  'Catalog': 'string',
                  'Id': 'string',
                  'Arn': 'string',
                  'ConnectionId': 'string',
                  'ConnectionType': 'OPPORTUNITY_COLLABORATION'|'SUBSIDIARY',
                  'CreatedAt': datetime(2015, 1, 1),
                  'UpdatedAt': datetime(2015, 1, 1),
                  'ExpiresAt': datetime(2015, 1, 1),
                  'OtherParticipantIdentifier': 'string',
                  'ParticipantType': 'SENDER'|'RECEIVER',
                  'Status': 'PENDING'|'ACCEPTED'|'REJECTED'|'CANCELED'|'EXPIRED'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ConnectionInvitationSummaries** *(list) --* 

        A list of connection invitation summaries matching the specified criteria.

        
        

        - *(dict) --* 

          A summary view of a connection invitation containing key information without full details.

          
          

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

            The catalog identifier where the connection invitation exists.

            
          

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

            The unique identifier of the connection invitation.

            
          

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

            The Amazon Resource Name (ARN) of the connection invitation.

            
          

          - **ConnectionId** *(string) --* 

            The identifier of the connection associated with this invitation.

            
          

          - **ConnectionType** *(string) --* 

            The type of connection being requested in the invitation.

            
          

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

            The timestamp when the connection invitation was created.

            
          

          - **UpdatedAt** *(datetime) --* 

            The timestamp when the connection invitation was last updated.

            
          

          - **ExpiresAt** *(datetime) --* 

            The timestamp when the connection invitation will expire.

            
          

          - **OtherParticipantIdentifier** *(string) --* 

            The identifier of the other participant in the connection invitation.

            
          

          - **ParticipantType** *(string) --* 

            The type of participant (inviter or invitee) in the connection invitation.

            
          

          - **Status** *(string) --* 

            The current status of the connection invitation.

            
      
    
      

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

  