---
title: "List user's domains"
method: GET
path: "/domains/list"
---

# List user's domains

`GET /domains/list`

## Request

- Base URL: `https://namemy.app/api/v1`
- URL: `https://namemy.app/api/v1/domains/list`
- Auth: HTTP bearer

Returns all domains owned by the authenticated API key user.

## Response `200`

List of domains

- object
  - `count` integer
  - `domains` Domain[]
    - `name` string
    - `status` 'active' | 'expired' | 'pending'
    - `expiresAt` string, date-time
    - `autoRenew` boolean
    - `privacyEnabled` boolean
    - `ownershipType` 'owned' | 'connected' | 'transferred'
    - `purchasePrice` number
    - `renewalPrice` number
    - `nameservers` string[]
    - `dnsProvider` string
    - `dnsRecords` object[]
      - `type` string
      - `host` string
      - `value` string
      - `ttl` integer
    - `emailForwards` object[]
      - `alias` string
      - `forwardTo` string
      - `status` string

## Other responses

- `401`: Missing or invalid API key
- `403`: Valid key but missing required permission
- `429`: Rate limit or daily quota exceeded

---

[API](https://skmtc.dev/namemy/apis/namemy-app-api.md) · [All operations](https://skmtc.dev/namemy/apis/namemy-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/namemy/apis/namemy-app-api/revisions/1c302ede4b63?raw)
