domains - secondary

Returns the details of a specific secondary domain.

This endpoint returns the details of a specific secondary domain, helping users manage and configure it effectively.</br></br>Key features include:</br></br>- Clear success messaging: Returns a 200 success code with a confirmation message indicating the successful completion of the requested action.</br>- Comprehensive error handling: Returns 400 and 404 error codes with clear descriptions when requests fail.</br>- Targeted data retrieval: Employs the domainId parameter to return the specified domain's details, ensuring accuracy and relevance in the response.

get/domains/secondary/{domainId}

Request

Path parameters

domainIdinteger required

Filters data by the domain's unique identifier.

Response

Secondary domain returned successfully.

idinteger
namestring
typestring
lastZoneTransferAtstring
zoneTransferStatusstring
createdAtstring
updatedAtstring
statusstring

status of the domain is active, pending or disabled.

Example response

[
  {
    "id": 1,
    "name": "example.com",
    "type": "primary",
    "lastZoneTransferAt": "2025-01-13T15:21:03.989+00:00",
    "zoneTransferStatus": "SUCCESS",
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2024-01-01T00:00:00Z",
    "status": "active",
    "queries": {
      "total": 200,
      "refused": 50,
      "servfail": 5,
      "notimpl": 5,
      "responsecount": 60,
      "noerror": 50,
      "nxdomain": 20,
      "formerr": 10
    },
    "secondaryIpSetConfig": {
      "secondaryIPSetId": 1,
      "name": "IpSet for Zone",
      "transferFrom": [
        [
          "10.9.150.1/32"
        ]
      ]
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.