Docs / API / Register Domain

Register Domain

Nameserver Update Required

Before calling this endpoint, you must update your domain's nameservers at your registrar to:

ns1.alinflow.com
ns2.alinflow.com

The API checks for these nameservers. If they are not detected, the registration request may fail or default to a "Pending" state.

Endpoint

POSThttps://dns.grovix.dev/v1/domain/register

Headers

Header	Value	Required
`Authorization`	`Bearer <token>`	Yes
`Content-Type`	`application/json`	Yes

Body Parameters

Parameter	Type	Required	Description
`domain`	string	Yes	The fully qualified domain name (e.g., `example.com`).

Example Request

curl -X POST "https://dns.grovix.dev/v1/domain/register" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com"
  }'

Success Response

{
  "success": true,
  "message": "Domain registered successfully",
  "data": {
    "_id": "651a...",
    "domain": "example.com",
    "status": "pending",
    "createdAt": "2023-11-25T10:00:00.000Z"
  }
}