Get DNS Records

GET

/dns

Returns all DNS records for a domain, including disabled records.

Disabled records are stored but not actively applied — they appear in data.disabledRecords separately from active data.records.

Request

Authorization

API Key

Add parameter in header

cmr-x-api-key

Example:

cmr-x-api-key: ********************

Query Params

Responses

🟢200Success

application/json

DNS records fetched successfully

Bodyapplication/json

🟠401Unauthorized

🟠422Unprocessable Entity

🟠400Bad Request

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://customers.coldmailreseller.com/api/v1/integration/dns?userId=H8M9JV2S9HMPYFQW393AZHQVD4XM&domain=acmecorp.com' \
--header 'cmr-x-api-key: <api-key>'

Response Example

200 - Example 1

{
    "status": 200,
    "message": "DNS records fetched successfully",
    "data": {
        "records": [
            {
                "recordId": "REC_abc123",
                "host": "@",
                "value": "1.2.3.4",
                "recordType": "A",
                "priority": "10",
                "ttl": "3600",
                "excludedDMARCtags": [
                    "string"
                ]
            }
        ],
        "disabledRecords": [
            {
                "recordId": "REC_abc123",
                "host": "@",
                "value": "ns1.provider.com.",
                "recordType": "NS",
                "ttl": "86400"
            }
        ]
    }
}

Modified at 2026-08-06 06:20:56

Delete Domains

Add DNS Records