Sign in

v58

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-073053701.0 MB
Domains: Transfer

Claim free domain transfer

Claim a free domain transfer available on your account and start the transfer.

Unlike purchasing a transfer, this consumes a free domain transfer you already have, so no payment method is required.

Before making request, unlock the domain at the current registrar and get its authorization code. The transfer is validated first, so domains which cannot be transferred are rejected before the free domain transfer is consumed.

A successful response means the transfer has been started. Completion depends on the current registrar and can be followed with the transfer list endpoint.

If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account.

Requests which cannot be fulfilled are rejected with an error code in the response body.

Use this endpoint to transfer a domain using a free domain transfer from your account.

post/api/domains/v1/transfers/claim

Request body

domainstring required

Domain name

auth_codestring required

Authorization code from the current registrar

should_keep_nsboolean

Keep the existing nameservers of the domain

Example request

{
  "domain": "my-new-domain.tld",
  "auth_code": "Auth123Code456",
  "domain_contacts": {
    "owner_id": 741288,
    "admin_id": 546123,
    "billing_id": 741288,
    "tech_id": 741288
  },
  "should_keep_ns": true
}

Response

Success response

domainstring

Domain name

statusstring

Transfer status

initiated_atstring date-time nullable

When the transfer was initiated

completed_atstring date-time nullable

When the transfer completed

Example response

{
  "domain": "mydomain.tld",
  "status": "Completed",
  "initiated_at": "2026-03-19T08:07:49Z",
  "completed_at": "2026-03-24T08:15:01Z"
}