:doc:`CognitoIdentity <../../cognito-identity>` / Client / describe_identity

*****************
describe_identity
*****************



.. py:method:: CognitoIdentity.Client.describe_identity(**kwargs)

  

  Returns metadata related to the given identity, including when the identity was created and any associated linked logins.

   

  You must use Amazon Web Services developer credentials to call this operation.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cognito-identity-2014-06-30/DescribeIdentity>`_  


  **Request Syntax**
  ::

    response = client.describe_identity(
        IdentityId='string'
    )
    
  :type IdentityId: string
  :param IdentityId: **[REQUIRED]** 

    A unique identifier in the format REGION:GUID.

    

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

    
    ::

      {
          'IdentityId': 'string',
          'Logins': [
              'string',
          ],
          'CreationDate': datetime(2015, 1, 1),
          'LastModifiedDate': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 

      A description of the identity.

      
      

      - **IdentityId** *(string) --* 

        A unique identifier in the format REGION:GUID.

        
      

      - **Logins** *(list) --* 

        The provider names.

        
        

        - *(string) --* 
    
      

      - **CreationDate** *(datetime) --* 

        Date on which the identity was created.

        
      

      - **LastModifiedDate** *(datetime) --* 

        Date on which the identity was last modified.

        
  
  **Exceptions**
  
  *   :py:class:`CognitoIdentity.Client.exceptions.InvalidParameterException`

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

  
  *   :py:class:`CognitoIdentity.Client.exceptions.NotAuthorizedException`

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

  
  *   :py:class:`CognitoIdentity.Client.exceptions.InternalErrorException`

  