:doc:`Route53Domains <../../route53domains>` / Client / retrieve_domain_auth_code

*************************
retrieve_domain_auth_code
*************************



.. py:method:: Route53Domains.Client.retrieve_domain_auth_code(**kwargs)

  

  This operation returns the authorization code for the domain. To transfer a domain to another registrar, you provide this value to the new registrar.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/RetrieveDomainAuthCode>`_  


  **Request Syntax**
  ::

    response = client.retrieve_domain_auth_code(
        DomainName='string'
    )
    
  :type DomainName: string
  :param DomainName: **[REQUIRED]** 

    The name of the domain that you want to get an authorization code for.

    

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

    
    ::

      {
          'AuthCode': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 

      The RetrieveDomainAuthCode response includes the following element.

      
      

      - **AuthCode** *(string) --* 

        The authorization code for the domain.

        
  
  **Exceptions**
  
  *   :py:class:`Route53Domains.Client.exceptions.InvalidInput`

  
  *   :py:class:`Route53Domains.Client.exceptions.UnsupportedTLD`

  