🥷
Namespace
  • [ Introduction ]
    • ENS
    • Namespace
      • Products and Services
      • Use Cases
  • [ Namespace Platform ]
    • Overview
    • Search & Registration
    • Manager
      • Listing an ENS Name
      • Features List
    • ENS Widget
    • Farcaster Frames
      • Default Frame
      • Custom Frame
    • Tutorials and Demos
  • [ Dev Docs ]
    • Overview
    • How-To Guides
      • Mint L1 or L2 subnames using SDK
    • Smart contracts
      • Namespace Minter
    • Backend API
      • POST /api/v1/mint
      • POST /api/v1/mint/verified
      • GET /api/v1/listings/availabe
    • Offchain Subnames API
      • Setting Up Offchain Resolver
      • Minting
        • Create a new ENS subname
      • Subnames
        • Resolve subname address
        • Check subname availability
        • Retrieve Complete Subname Dataset
        • Subname Search
        • Delete Subname
      • Text Records
        • Create or update subname text record
        • Delete a subname text record
        • Retrieve single subname text record
        • Retrieve all of subname's text records
      • Custom Data
        • Create or update custom subname data
        • Delete custom subname data
        • Retrieve single custom data object
        • Retrieve all of subname's custom data
    • Namespace SDK
      • Offchain Manager
        • Installation
        • Methods
        • Generate API key
        • CreateSubname
        • DeleteSubname
        • IsSubnameAvailable
        • GetFilteredSubnames
        • TextRecords
        • DataRecords
      • Indexer Manager
        • Installation
        • Methods
        • GetL2Subname
        • GetL2Subnames
        • GetL1Subnames
        • GetL1Subnames
        • GetL1Subname
      • Namespace Client (deprecated)
        • Installation
        • GetListedName
        • GetMintDetails
        • GetMintTransactionParameters
        • IsSubnameAvailable
        • GenerateAuthToken
    • Namespace L2 Subnames
  • [ ecosystem ]
    • Partnerships
    • Integrations
    • Links
    • ENS ideas and projects
  • [ Legal ]
    • Disclamer
    • Terms of Service
    • Privacy Policy
Powered by GitBook
On this page
  1. [ Dev Docs ]
  2. Offchain Subnames API
  3. Subnames

Subname Search

GET /v1/subname/search

PreviousRetrieve Complete Subname DatasetNextDelete Subname

Last updated 10 months ago

Returns subname details based on the provided search query, as outlined in Query Parameters.

get
Query parameters
domainstringrequired

A parent ENS name

searchLabelstringrequired

string that matches subname label

currentPagenumberrequired

Current page of paginated response

Default: 0
pageSizenumberrequired

Page size of paginated response

Default: 25
dataRecordsstringrequired

Find subnames data records

textRecordsstringrequired

Find subnames by text record

Responses
application/json
application/json
get
curl -L \
  --url '/v1/subname/search?domain=text&searchLabel=text&currentPage=1&pageSize=1&dataRecords=text&textRecords=text'
500
default
{
  "status": 400,
  "path": "text",
  "error": [
    {
      "property": "text",
      "value": "text",
      "message": "text"
    }
  ]
}

Error with the message identifying which parameters caused the bad request.