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
idstringrequiredThe domain ID. From
GET /api/v2/domains.Example
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.
{ "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 | nullThe domain name.
glueRecordsarray of objectThe registered glue records.
hostnamestringThe nameserver hostname.
ipsarray of stringThe IP addresses registered for the nameserver.
countintegerNumber of glue records.
registryLimitobjectHow many glue records the domain has (
current) against the registry limit (max).currentintegermaxintegerreachedbooleanactionsobjectcanCreateGlueRecordobjectWhether another glue record can be created, with the reason when it cannot.
allowedbooleanreasonstring | nullErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is domain_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |