:doc:`IAM <../../iam>` / Client / get_mfa_device

**************
get_mfa_device
**************



.. py:method:: IAM.Client.get_mfa_device(**kwargs)

  

  Retrieves information about an MFA device for a specified user.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/GetMFADevice>`_  


  **Request Syntax**
  ::

    response = client.get_mfa_device(
        SerialNumber='string',
        UserName='string'
    )
    
  :type SerialNumber: string
  :param SerialNumber: **[REQUIRED]** 

    Serial number that uniquely identifies the MFA device. For this API, we only accept FIDO security key `ARNs <https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html>`__.

    

  
  :type UserName: string
  :param UserName: 

    The friendly name identifying the user.

    

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

    
    ::

      {
          'UserName': 'string',
          'SerialNumber': 'string',
          'EnableDate': datetime(2015, 1, 1),
          'Certifications': {
              'string': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **UserName** *(string) --* 

        The friendly name identifying the user.

        
      

      - **SerialNumber** *(string) --* 

        Serial number that uniquely identifies the MFA device. For this API, we only accept FIDO security key `ARNs <https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html>`__.

        
      

      - **EnableDate** *(datetime) --* 

        The date that a specified user's MFA device was first enabled.

        
      

      - **Certifications** *(dict) --* 

        The certifications of a specified user's MFA device. We currently provide FIPS-140-2, FIPS-140-3, and FIDO certification levels obtained from `FIDO Alliance Metadata Service (MDS) <https://fidoalliance.org/metadata/>`__.

        
        

        - *(string) --* 
          

          - *(string) --* 
    
  
  
  **Exceptions**
  
  *   :py:class:`IAM.Client.exceptions.NoSuchEntityException`

  
  *   :py:class:`IAM.Client.exceptions.ServiceFailureException`

  