Claim free domain transfer

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

Claim free domain transfer

post

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.

Authorizations

AuthorizationstringRequired

API Token authentication

Body

domainstringRequired

Domain name

Example: my-new-domain.tld

auth_codestringRequired

Authorization code from the current registrar

Example: Auth123Code456

should_keep_nsbooleanOptional

Keep the existing nameservers of the domain

Default: trueExample: true

Responses

200

Success response

application/json

domainstringOptional

Domain name

Example: mydomain.tld

statusstringOptional

Transfer status

Example: Completed

initiated_atstring · date-time · nullableOptional

When the transfer was initiated

Example: 2026-03-19T08:07:49Z

completed_atstring · date-time · nullableOptional

When the transfer completed

Example: 2026-03-24T08:15:01Z

401

Unauthenticated response

application/json

422

Validation error response

application/json

500

Error response

application/json

post/api/domains/v1/transfers/claim

POST /api/domains/v1/transfers/claim HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "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
}

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