Method: projects.locations.registrations.retrieveTransferParameters

Gets parameters needed to transfer a domain name from another registrar to Cloud Domains. For domains managed by Google Domains, transferring to Cloud Domains is not supported.

Use the returned values to call registrations.transfer.

HTTP request

GET https://domains.googleapis.com/v1/{location=projects/*/locations/*}/registrations:retrieveTransferParameters

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
location

string

Required. The location. Must be in the format projects/*/locations/*.

Authorization requires the following IAM permission on the specified resource location:

  • domains.registrations.list

Query parameters

Parameters
domainName

string

Required. The domain name. Unicode domain names must be expressed in Punycode format.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response for the registrations.retrieveTransferParameters method.

JSON representation
{
  "transferParameters": {
    object (TransferParameters)
  }
}
Fields
transferParameters

object (TransferParameters)

Parameters to use when calling the registrations.transfer method.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

TransferParameters

Parameters required to transfer a domain from another registrar.

JSON representation
{
  "domainName": string,
  "currentRegistrar": string,
  "nameServers": [
    string
  ],
  "transferLockState": enum (TransferLockState),
  "supportedPrivacy": [
    enum (ContactPrivacy)
  ],
  "yearlyPrice": {
    object (Money)
  }
}
Fields
domainName

string

The domain name. Unicode domain names are expressed in Punycode format.

currentRegistrar

string

The registrar that currently manages the domain.

nameServers[]

string

The name servers that currently store the configuration of the domain.

transferLockState

enum (TransferLockState)

Indicates whether the domain is protected by a transfer lock. For a transfer to succeed, this must show UNLOCKED. To unlock a domain, go to its current registrar.

supportedPrivacy[]

enum (ContactPrivacy)

Contact privacy options that the domain supports.

yearlyPrice

object (Money)

Price to transfer or renew the domain for one year.