List domain records
GEThttps://api.instacloud.com/orgs/{orgId}/domains/{domainName}/records
Token scope: account · org — read-only tokens allowed.
The DNS records in a bought domain's zone, as the registrar holds them. A record InstaCloud published is managed: read-only while the attached hostname in hostname claims it; with no hostname, a leftover that may be deleted.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
orgId | path | string | yes | |
domainName | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
items | object[] | yes | |
items.id | integer | yes | the registrar's id for the record; the handle every write takes |
items.type | "A" | "AAAA" | "ANAME" | "CNAME" | "MX" | "NS" | "SRV" | "TXT" | yes | |
items.host | string | yes | relative to the domain: "@" is the domain itself, "api" is api.<domain> |
items.fqdn | string | yes | |
items.answer | string | yes | |
items.ttl | integer | yes | seconds |
items.priority | integer | no | MX and SRV only |
items.managed | boolean | yes | published by InstaCloud: read-only while `hostname` names the attached hostname it serves; without one, a leftover no hostname claims, which may be deleted |
items.hostname | string | no | the attached hostname a managed record serves |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
502
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
503
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |