Get the transfer code of a bought domain
get_domain_transfer_code
Returns the transfer code of a domain the workspace bought, which the registrar it moves to asks for.
The code comes back in AuthCode, also called the auth code. It is a live credential: anyone holding it can move the domain away once its transfer lock is off, which is why the tool tells the client to hand the code only to you, and why it needs two scopes: credentials:reveal and domains:write. A token that holds only one of them does not see the tool, and a call with it is refused. Name.com does not give one out for a domain in its first 60 days or for 60 days after its owner changed.
Only the workspace owner can get it, and the domain must be active or expiring. Each code counts as a change toward the workspace's 30 domain changes a minute. See Transfer code.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
workspaceId |
string | Yes | The workspace that owns the domain. |
domainId |
string | Yes | The _id of the bought domain, from list_bought_domains. |