Get DNS records for a domain zone

View all DNS records associated with a specific domain zone. This is useful for viewing or troubleshooting your domain's DNS settings.

Domain Services DNS

Context

Used in the dashboard

/cdn /domains/bulk-dns

Where to get IDs / values

path.zoneId

GET /api/dns/zones

Workflow links

Produces

zoneId → data.zone.id

POST /api/dns/zones/{zoneId}/records
PUT /api/dns/zones/{zoneId}/records/{recordId}
DELETE /api/dns/zones/{zoneId}/records/{recordId}
recordId → data.zone.records[].id

PUT /api/dns/zones/{zoneId}/records/{recordId}
DELETE /api/dns/zones/{zoneId}/records/{recordId}

Related endpoints

POST /api/dns/zones/{zoneId}/records Add or modify DNS records for a domain PUT /api/dns/zones/{zoneId}/records/{recordId} Update DNS records for a domain zone DELETE /api/dns/zones/{zoneId}/records/{recordId} Delete a specific DNS record from a domain

Path Parameters

zoneId integer · min: 1 required Example: 19513

Unique zone identifier

Headers

Accept Example

Content-Type Example

Responses

200

data object required

data.zone object required

data.zone.domain string required · Example: example.com

data.zone.id string required · Example: 19513

data.zone.records array<object> required · Example: [{"id":35994594,"type":"SOA","name":"example.com","value":"primary.ns.hostup.se registr...

data.zone.records[].created string required · Example: 2026-02-10T00:00:00.000Z

data.zone.records[].id integer required · Example: 35994594

Record identifier. May be returned as a number or a string (fallback) if the upstream provider doesn't return an ID immediately. Treat as opaque.

data.zone.records[].name string required · Example: example.com

Record name (often returned as FQDN). Root record may be returned as the zone domain. "@"/empty are treated as root on input.

data.zone.records[].status string · enum required · Example: active

Record status. Mutations typically return 'pending' immediately; list/GET endpoints usually return 'active'.

pending

active

data.zone.records[].ttl integer required · Example: 7200

TTL in seconds.

data.zone.records[].type string · enum required · Example: SOA

DNS record type. One of: A, AAAA, CNAME, ALIAS, MX, TXT, SRV, CAA, TLSA, NS.

A

AAAA

CNAME

ALIAS

MX

TXT

SRV

CAA

TLSA

NS

data.zone.records[].value string required · Example: primary.ns.hostup.se registry.hostup.se 2025122364 3600 1800 604800 600

Record value.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

400 Standard error response

error string required

HTTP status title (e.g. 'Bad Request').

message string required

Human-readable message.

code string required

Machine-readable error code.

timestamp string required

ISO 8601 timestamp (UTC).

requestId string required

Unique request identifier (UUID).

details array<object>

Optional validation details (field-level errors).

details[].field string

details[].message string

Human-readable message.

details[].code string

Machine-readable error code.

retryAfter string

When to retry (ISO 8601 timestamp, UTC).

401 Standard error response

error string required

HTTP status title (e.g. 'Bad Request').

message string required

Human-readable message.

code string required

Machine-readable error code.

timestamp string required

ISO 8601 timestamp (UTC).

requestId string required

Unique request identifier (UUID).

details array<object>

Optional validation details (field-level errors).

details[].field string

details[].message string

Human-readable message.

details[].code string

Machine-readable error code.

retryAfter string

When to retry (ISO 8601 timestamp, UTC).

403 Standard error response

error string required

HTTP status title (e.g. 'Bad Request').

message string required

Human-readable message.

code string required

Machine-readable error code.

timestamp string required

ISO 8601 timestamp (UTC).

requestId string required

Unique request identifier (UUID).

details array<object>

Optional validation details (field-level errors).

details[].field string

details[].message string

Human-readable message.

details[].code string

Machine-readable error code.

retryAfter string

When to retry (ISO 8601 timestamp, UTC).

404

code string required · Example: NOT_FOUND

Machine-readable error code.

error string required · Example: Not Found

HTTP status title (e.g. 'Bad Request').

message string required · Example: dns.zone_not_found not found

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

429 Standard error response

error string required

HTTP status title (e.g. 'Bad Request').

message string required

Human-readable message.

code string required

Machine-readable error code.

timestamp string required

ISO 8601 timestamp (UTC).

requestId string required

Unique request identifier (UUID).

details array<object>

Optional validation details (field-level errors).

details[].field string

details[].message string

Human-readable message.

details[].code string

Machine-readable error code.

retryAfter string

When to retry (ISO 8601 timestamp, UTC).

500 Standard error response

error string required

HTTP status title (e.g. 'Bad Request').

message string required

Human-readable message.

code string required

Machine-readable error code.

timestamp string required

ISO 8601 timestamp (UTC).

requestId string required

Unique request identifier (UUID).

details array<object>

Optional validation details (field-level errors).

details[].field string

details[].message string

Human-readable message.

details[].code string

Machine-readable error code.

retryAfter string

When to retry (ISO 8601 timestamp, UTC).

GET https://cloud.hostup.se/api/dns/zones/{zoneId}/records

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/dns/zones/19513/records" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "zone": {
      "id": "19513",
      "domain": "example.com",
      "records": [
        {
          "id": 35994594,
          "type": "SOA",
          "name": "example.com",
          "value": "primary.ns.hostup.se registry.hostup.se 2025122364 3600 1800 604800 600",
          "ttl": 7200,
          "status": "active",
          "created": "2026-02-10T00:00:00.000Z"
        },
        {
          "id": 35994595,
          "type": "NS",
          "name": "example.com",
          "value": "primary.ns.hostup.se",
          "ttl": 86400,
          "status": "active",
          "created": "2026-02-10T00:00:00.000Z"
        },
        {
          "_truncated": "... and 17 more items"
        }
      ]
    }
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "zone": {
          "type": "object",
          "properties": {
            "domain": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "records": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "created": {
                    "type": "string"
                  },
                  "id": {
                    "type": "integer",
                    "description": "Record identifier. May be returned as a number or a string (fallback) if the upstream provider doesn't return an ID immediately. Treat as opaque."
                  },
                  "name": {
                    "type": "string",
                    "description": "Record name (often returned as FQDN). Root record may be returned as the zone domain. \"@\"/empty are treated as root on input."
                  },
                  "status": {
                    "type": "string",
                    "description": "Record status. Mutations typically return 'pending' immediately; list/GET endpoints usually return 'active'.",
                    "enum": [
                      "pending",
                      "active"
                    ]
                  },
                  "ttl": {
                    "type": "integer",
                    "description": "TTL in seconds."
                  },
                  "type": {
                    "type": "string",
                    "description": "DNS record type. One of: A, AAAA, CNAME, ALIAS, MX, TXT, SRV, CAA, TLSA, NS.",
                    "enum": [
                      "A",
                      "AAAA",
                      "CNAME",
                      "ALIAS",
                      "MX",
                      "TXT",
                      "SRV",
                      "CAA",
                      "TLSA",
                      "NS"
                    ]
                  },
                  "value": {
                    "type": "string",
                    "description": "Record value."
                  }
                }
              }
            }
          }
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}