Skip to content

List glue records

GET /api/v2/domains/{id}/glue-records

Lists the glue records registered for the domain’s own nameservers, such as ns1.example.se for example.se. Glue records are needed when a domain uses nameservers named under itself. They are kept at the registry, not in the DNS zone. Glue records are available for .se, .nu and .test domains. Other domains return an empty list with actions.canCreateGlueRecord.allowed: false and the reason. The registry limit is 13 glue records per domain.

Authentication: An API key with the scope read:domains. About keys and scopes

Request

Path parameters

idstringrequired
The domain ID. From GET /api/v2/domains.

Example

GET /api/v2/domains/{id}/glue-records
curl "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/glue-records" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 The glue records, the registry limit and whether another one can be created.

Response 200
{
"domainName": "example.se",
"glueRecords": [
{
"hostname": "ns1.example.se",
"ips": [
"192.0.2.10",
"2001:db8::10"
]
}
],
"count": 1,
"registryLimit": {
"current": 1,
"max": 13,
"reached": false
},
"actions": {
"canCreateGlueRecord": {
"allowed": true,
"reason": null
}
}
}
Response fields
domainNamestring | null
The domain name.
glueRecordsarray of object
The registered glue records.
hostnamestring
The nameserver hostname.
ipsarray of string
The IP addresses registered for the nameserver.
countinteger
Number of glue records.
registryLimitobject
How many glue records the domain has (current) against the registry limit (max).
currentinteger
maxinteger
reachedboolean
actionsobject
canCreateGlueRecordobject
Whether another glue record can be created, with the reason when it cannot.
allowedboolean
reasonstring | null

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller; code is domain_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.