Skip to content

MCP for AI agents30 toolsYour AI agent works with the rights you give it. Registering, transferring and cancelling stay in the customer area. If you give it the right, it can retrieve the transfer code of a domain: at most 3 retrievals per domain and day, and every retrieval is logged.

Read the MCP docs
DNS automation
v1.6.2
Download OpenAPI
YAMLJSON

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

Authentication

x-api-key
Getting startedAuthenticationCustomer areaCreate an API key in the regfish console and test it

Parameters

Name
Type
Format
Required
Description
filter
query
string
-
Optional
Comma-separated list of filters. Supported values are `cancelled` and `dnssec-inactive`.
page
query
integer
-
Optional
-
pageSize
query
integer
-
Optional
-
search
query
string
-
Optional
Case-insensitive partial match against the domain name, owner label, or primary nameserver.
sortBy
query
string
-
Optional
Sort by one of the public response fields listed in `domainListSortKey`.
sortOrder
query
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
application/jsondomainListResponse
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
application/jsonError
Response example 400
{
  "success": false,
  "message": "Invalid query parameters",
  "error": "Invalid query parameters"
}
401
Unauthorized
application/jsonError
Response example 401
{
  "success": false,
  "message": "Unauthorized",
  "error": "Unauthorized"
}
500
Unexpected error
application/jsonError
Response example 500
{
  "success": false,
  "message": "Unexpected error",
  "error": "Unexpected error"
}
Community

Become part of the community

The regfish DNS API is a great solution for developers who want to automate domains and DNS zones. Become part of the community and benefit from DNS automation. The DNS API is available free of charge to every regfish customer.

More free features