---
title: "Claim free domain"
method: POST
path: "/api/domains/v1/portfolio/claim"
tags: ["Domains: Portfolio"]
---

# Claim free domain

`POST /api/domains/v1/portfolio/claim`

Claim a free domain available on your account and register it.

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

A successful response means the domain is registered. If registration fails, login to
[hPanel](https://hpanel.hostinger.com/) and check domain registration status.

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.

Some TLDs require `additional_details` to be provided and these will be validated before claiming.

Requests which cannot be fulfilled are rejected with an error code in the response body,
for example `2037` when no free domain is available.

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

## Request body

- DomainsV1PortfolioClaimRequest
  - `domain` string, required — Domain name
  - `domain_contacts` object — Domain contact information
    - `owner_id` integer — Owner contact WHOIS record ID
    - `admin_id` integer — Administrative contact WHOIS record ID
    - `billing_id` integer — Billing contact WHOIS record ID
    - `tech_id` integer — Technical contact WHOIS record ID
  - `additional_details` object — Additional registration data, possible values depends on TLD

## Response `200`

Success response

- DomainsV1PortfolioClaimResource
  - `domain` string, nullable — Domain name
  - `status` 'active' | 'pending_setup' | 'expired' | 'requested' | 'pending_verification' | 'deleted' | 'suspended' | 'failed', nullable — Domain status
  - `created_at` string, date-time, nullable

## Other responses

- `401` — Unauthenticated response
- `422` — Validation error response
- `500` — Error response

---

[API](https://skmtc.net/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.net/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/versions/796bd5194565/schema)