:doc:`Connect <../../connect>` / Client / list_associated_contacts

************************
list_associated_contacts
************************



.. py:method:: Connect.Client.list_associated_contacts(**kwargs)

  

  Provides information about contact tree, a list of associated contacts with a unique identifier.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListAssociatedContacts>`_  


  **Request Syntax**
  ::

    response = client.list_associated_contacts(
        InstanceId='string',
        ContactId='string',
        MaxResults=123,
        NextToken='string'
    )
    
  :type InstanceId: string
  :param InstanceId: **[REQUIRED]** 

    The identifier of the Amazon Connect instance. You can `find the instance ID <https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html>`__ in the Amazon Resource Name (ARN) of the instance.

    

  
  :type ContactId: string
  :param ContactId: **[REQUIRED]** 

    The identifier of the contact in this instance of Amazon Connect.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of results to return per page.

    

  
  :type NextToken: string
  :param NextToken: 

    The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

    

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

    
    ::

      {
          'ContactSummaryList': [
              {
                  'ContactId': 'string',
                  'ContactArn': 'string',
                  'InitiationTimestamp': datetime(2015, 1, 1),
                  'DisconnectTimestamp': datetime(2015, 1, 1),
                  'InitialContactId': 'string',
                  'PreviousContactId': 'string',
                  'RelatedContactId': 'string',
                  'InitiationMethod': 'INBOUND'|'OUTBOUND'|'TRANSFER'|'QUEUE_TRANSFER'|'CALLBACK'|'API'|'DISCONNECT'|'MONITOR'|'EXTERNAL_OUTBOUND'|'WEBRTC_API'|'AGENT_REPLY'|'FLOW',
                  'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ContactSummaryList** *(list) --* 

        List of the contact summary for all the contacts in contact tree associated with unique identifier.

        
        

        - *(dict) --* 

          Contact summary of a contact in contact tree associated with unique identifier.

          
          

          - **ContactId** *(string) --* 

            The identifier of the contact in this instance of Amazon Connect.

            
          

          - **ContactArn** *(string) --* 

            The Amazon Resource Name (ARN) of the contact

            
          

          - **InitiationTimestamp** *(datetime) --* 

            The date and time this contact was initiated, in UTC time.

            
          

          - **DisconnectTimestamp** *(datetime) --* 

            The date and time that the customer endpoint disconnected from the current contact, in UTC time. In transfer scenarios, the DisconnectTimestamp of the previous contact indicates the date and time when that contact ended.

            
          

          - **InitialContactId** *(string) --* 

            If this contact is related to other contacts, this is the ID of the initial contact.

            
          

          - **PreviousContactId** *(string) --* 

            If this contact is not the first contact, this is the ID of the previous contact.

            
          

          - **RelatedContactId** *(string) --* 

            The contactId that is related to this contact.

            
          

          - **InitiationMethod** *(string) --* 

            Indicates how the contact was initiated.

            
          

          - **Channel** *(string) --* 

            How the contact reached your contact center.

            
      
    
      

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

        If there are additional results, this is the token for the next set of results.

        
  
  **Exceptions**
  
  *   :py:class:`Connect.Client.exceptions.InternalServiceException`

  
  *   :py:class:`Connect.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`Connect.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`Connect.Client.exceptions.ResourceNotFoundException`

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

  