GET /v1/domains — List All Domains in Your Workspace

This endpoint returns every domain currently registered under your workspace. Use it to build dashboards, monitor expiry dates, or audit auto-renew and privacy settings across your entire portfolio. Results are returned as a flat array — no pagination is applied, so you always receive the full list in one response.

Request

Method: GET
Path: /v1/domains

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

Request Example

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

Response — 200 OK

array

An array of domain objects, one for each domain in your workspace.

Show domains[]

string

The fully-qualified domain name (e.g. example.com).

string

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

boolean

true if the domain is set to renew automatically before it expires.

boolean

true if WHOIS privacy protection is active for this domain.

string

ISO 8601 timestamp indicating when the domain registration expires.

string

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

{
  "domains": [
    {
      "name": "example.com",
      "status": "active",
      "autoRenew": true,
      "privacyEnabled": true,
      "expiresAt": "2027-01-04T12:00:00.000Z",
      "createdAt": "2026-01-04T12:00:00.000Z"
    }
  ]
}

Overview

Domains

DNS Records

Account

GET /v1/domains — List All Domains in Your Workspace

Request

Request Example

Response — 200 OK

​Request

​Request Example

​Response — 200 OK

Request

Request Example

Response — 200 OK