GET /v1/domains/{domain} — Retrieve Full Domain Details

Use this endpoint to fetch the complete details for a single domain in your workspace. The response includes its current status, active nameservers, registration length, expiry date, and the settings you configured at registration or updated since. Unlike the list endpoint, this gives you the full picture for one specific domain in a single call.

Request

Method: GET
Path: /v1/domains/{domain}

Header	Required	Value
`x-api-key`	Yes	Your API key

Path Parameters

string

required

The domain name itself — for example, example.com. This is the human-readable name, not an internal ID.

Request Example

curl https://api.namegrid.org/v1/domains/example.com \
  -H "x-api-key: ng_live_xxxxxxxxxxxxxxxxxxxxxxxx"

Response — 200 OK

object

Full detail object for the requested domain.

Show domain fields

string

The fully-qualified domain name.

string

Current state of the domain. Possible values: active, expiring_soon, expired, failed.

boolean

true if automatic renewal is enabled for this domain.

boolean

true if WHOIS privacy protection is currently active.

string[]

The list of nameserver hostnames currently delegated for this domain.

integer

The number of years this domain was most recently registered or renewed for.

string

ISO 8601 timestamp indicating when the current registration period ends.

string

ISO 8601 timestamp indicating when the domain was first registered through NameGrid.

{
  "domain": {
    "name": "example.com",
    "status": "active",
    "autoRenew": true,
    "privacyEnabled": true,
    "nameservers": ["ns1.namegrid.org", "ns2.namegrid.org"],
    "years": 1,
    "expiresAt": "2027-01-04T12:00:00.000Z",
    "createdAt": "2026-01-04T12:00:00.000Z"
  }
}

Errors

Status	Reason
`404`	The domain does not exist or is not owned by your workspace

Overview

Domains

DNS Records

Account

GET /v1/domains/{domain} — Retrieve Full Domain Details

Request

Path Parameters

Request Example

Response — 200 OK

Errors

​Request

​Path Parameters

​Request Example

​Response — 200 OK

​Errors

Request

Path Parameters

Request Example

Response — 200 OK

Errors