© 2002-2026 regfish GmbH. Regfish is a registered trademark of regfish GmbH. All prices include VAT. No guarantee for completeness. Our Terms and Conditions.
GET
/domains
Domains
Authentication
Parameters
Name
Type
Format
Required
Description
filter
string
—
Optional
Comma-separated list of filters. Supported values are `cancelled` and `dnssec-inactive`.
page
integer
—
Optional
—
pageSize
integer
—
Optional
—
search
string
—
Optional
Case-insensitive partial match against the domain name, owner label, or primary nameserver.
sortBy
string
—
Optional
Sort by one of the public response fields listed in `domainListSortKey`.
sortOrder
string
—
Optional
—
Request example
GET
curl --request GET \
--url 'https://api.regfish.com/domains?filter=example&page=1&pageSize=100&search=example&sortBy=domain&sortOrder=asc' \
--header 'x-api-key: YOUR_API_KEY'Responses
200
Customer domain list
Response example 200
{
"success": true,
"code": 0,
"response": {
"domains": [
{
"domain": "www.example.com",
"sld": "example",
"tld": "example",
"favorite": true,
"owner": "example",
"primary_nameserver": "example",
"dnssec_state": "active",
"auto_renew": true,
"cancelled": true,
"registered_at": 1,
"expires_at": 1
}
],
"total_items": 1,
"total_pages": 1,
"page": 1,
"page_size": 1,
"search": "example",
"filters": [
"cancelled"
],
"sort_by": "domain",
"sort_order": "asc"
}
}400
Invalid query parameters
Response example 400
{
"success": false,
"message": "Invalid query parameters",
"error": "Invalid query parameters"
}401
Unauthorized
Response example 401
{
"success": false,
"message": "Unauthorized",
"error": "Unauthorized"
}500
Unexpected error
Response example 500
{
"success": false,
"message": "Unexpected error",
"error": "Unexpected error"
}