> ## 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 — List All Domains in Your Workspace

> GET /v1/domains — List all domains owned by your workspace. Returns name, status, auto-renew, privacy, and expiry date for each domain.

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

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

## Response — 200 OK

<ResponseField name="domains" type="array">
  An array of domain objects, one for each domain in your workspace.

  <Expandable title="domains[]">
    <ResponseField name="name" type="string">
      The fully-qualified domain name (e.g. `example.com`).
    </ResponseField>

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

    <ResponseField name="autoRenew" type="boolean">
      `true` if the domain is set to renew automatically before it expires.
    </ResponseField>

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

    <ResponseField name="expiresAt" type="string">
      ISO 8601 timestamp indicating when the domain registration expires.
    </ResponseField>

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

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