# List domain records

`GET https://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 |  |

## Response 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 |

## Response 404

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 502

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |

## Response 503

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |