DNS API-Referenz
v1.6.2
List customer domains
List registered domains together with key portfolio details such as owner label, DNSSEC status, renewal status, and expiry date. Supports text search, filtering, sorting, and pagination.
GET
/domains
Domains
Authentifizierung
Parameter
Name
Typ
Format
Pflicht
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-Beispiel
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-Beispiel 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-Beispiel 400
{
"success": false,
"message": "Invalid query parameters",
"error": "Invalid query parameters"
}401
Unauthorized
Response-Beispiel 401
{
"success": false,
"message": "Unauthorized",
"error": "Unauthorized"
}500
Unexpected error
Response-Beispiel 500
{
"success": false,
"message": "Unexpected error",
"error": "Unexpected error"
}Community
Werden Sie ein Teil der Community
Das DNS API von regfish ist die perfekte Lösung für Entwickler, die ihre Domains und DNS-Zonen automatisieren möchten. Werden Sie Teil der Community und profitieren Sie von den Vorteilen der DNS-Automatisierung. Das DNS API steht jedem regfish-Kunden kostenlos zur Verfügung.