> ## Documentation Index
> Fetch the complete documentation index at: https://docs.namegrid.org/llms.txt
> Use this file to discover all available pages before exploring further.

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

> GET /v1/domains/{domain} — Retrieve full details for a single domain including status, nameservers, auto-renew, privacy, and expiry date.

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

<ParamField path="domain" type="string" required>
  The domain name itself — for example, `example.com`. This is the human-readable name, not an internal ID.
</ParamField>

### Request Example

```bash theme={null}
curl https://api.namegrid.org/v1/domains/example.com \
  -H "x-api-key: ng_live_xxxxxxxxxxxxxxxxxxxxxxxx"
```

## Response — 200 OK

<ResponseField name="domain" type="object">
  Full detail object for the requested domain.

  <Expandable title="domain fields">
    <ResponseField name="name" type="string">
      The fully-qualified domain name.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current state of the domain. Possible values: `active`, `expiring_soon`, `expired`, `failed`.
    </ResponseField>

    <ResponseField name="autoRenew" type="boolean">
      `true` if automatic renewal is enabled for this domain.
    </ResponseField>

    <ResponseField name="privacyEnabled" type="boolean">
      `true` if WHOIS privacy protection is currently active.
    </ResponseField>

    <ResponseField name="nameservers" type="string[]">
      The list of nameserver hostnames currently delegated for this domain.
    </ResponseField>

    <ResponseField name="years" type="integer">
      The number of years this domain was most recently registered or renewed for.
    </ResponseField>

    <ResponseField name="expiresAt" type="string">
      ISO 8601 timestamp indicating when the current registration period ends.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp indicating when the domain was first registered through NameGrid.
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "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 |