---
title: "Get a list of subnames for an address"
method: GET
path: "/v1/subnames"
tags: ["experimental"]
---

# Get a list of subnames for an address

`GET /v1/subnames`

## Request

- Base URL: `http://api.enoki.mystenlabs.com`
- URL: `http://api.enoki.mystenlabs.com/v1/subnames`
- Auth: HTTP bearer

Get a list of subnames for an address

## Query parameters

- `network` 'testnet' | 'mainnet': The network subnames are registered on.
- `domain` string: The domain name the subname is on.
- `address` string: The address to resolve subnames for

## Response `200`

Successful response

- GetSubnamesResponse
  - `data` object, required
    - `subnames` object[], required
      - `name` string, required
      - `status` 'PENDING' | 'ACTIVE', required
      - `createdAt` string, date-time, required: The date and time the subname was created in ISO 8601 format

---

[API](https://skmtc.dev/mystenlabs/apis/enoki-api-specification.md) - [All operations](https://skmtc.dev/mystenlabs/apis/enoki-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/mystenlabs/apis/enoki-api-specification/revisions/2ac8d418823a?raw)