/v1/account/domains
API Key
Paginated
List domains
List all domains for the authenticated account, ordered by primary status and creation date.
Parameters
| Name | Location | Type | Description |
|---|---|---|---|
txt_status
|
query | string |
Filter by TXT verification status
Values: pending, verified, expired, suspended
|
fully_verified
|
query | string | Filter to only fully verified domains (true) |
primary
|
query | string | Filter to only primary domain (true) |
page
|
query | integer | Page number for pagination |
per_page
|
query | integer | Items per page (default: 25, max: 100) |
X-API-Key
*
|
header | string | API key for authentication |
* Required parameter
Response
Content-Type: application/json
success
boolean
data
array[object]
Array items:
A custom domain for the account's verifiable credentials
domain
*
string
The domain name (also serves as unique identifier)
Example: trust.example.com
did
*
string
The DID derived from this domain
Example: did:web:trust.example.com
primary
*
boolean
Whether this is the primary domain for the account
Example: true
fully_verified
*
boolean
Whether both TXT and CNAME verification have passed
Example: true
txt_status
*
string
TXT record verification status
Allowed values: "pending", "verified", "failed"
Example: verified
txt_verified_at
string (date-time)
nullable
When TXT verification passed
Example: 2025-01-10T09:00:00Z
cname_verified
*
boolean
Whether CNAME verification has passed
Example: true
cname_verified_at
string (date-time)
nullable
When CNAME verification passed
Example: 2025-01-10T09:30:00Z
created_at
*
string (date-time)
When the domain was created
Example: 2025-01-01T00:00:00Z
updated_at
*
string (date-time)
When the domain was last updated
Example: 2025-01-10T09:30:00Z
meta
object
current_page
integer
total_pages
integer
total_count
integer
per_page
integer
Code Examples
import os
from aho_sdk import AhoSdk
client = AhoSdk.account(api_key=os.environ["AHO_API_KEY"])
result = client.domains.listclient = AhoSdk.account(api_key: ENV["AHO_API_KEY"])
result = client.domains.listimport { AhoSdk } from '@aho/sdk';
const client = AhoSdk.account({ apiKey: process.env.AHO_API_KEY });
const result = await client.domains.list;curl -X GET 'https://api.aho.com/v1/account/domains' \
-H 'X-API-Key: $AHO_API_KEY'Try It
Log in to test this endpoint directly from the documentation.
Log in