--- title: List Scanned DNS Records --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [DNS](https://developers.cloudflare.com/api/resources/dns) [Records](https://developers.cloudflare.com/api/resources/dns/subresources/records) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Scanned DNS Records GET/zones/{zone\_id}/dns\_records/scan/review Retrieves the list of DNS records discovered up to this point by the asynchronous scan. These records are temporary until explicitly accepted or rejected via `POST /scan/review`. Additional records may be discovered by the scan later. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `DNS Read``DNS Write` ##### P ath ParametersExpand Collapse zone\_id: string Identifier. maxLength32 [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20scan_list%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of object {code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20scan_list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of object {code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20scan_list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20scan_list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result: optional array of RecordResponse

One of the following:

ARecord = ARecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

dead\_glue: optional boolean Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property is\_glue: optional boolean Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: optional array of string IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: optional number Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property

Link to this property modified\_on: string When the record was last modified. formatdate-time Link to this property proxiable: boolean Whether the record can be proxied by Cloudflare or not. Link to this property comment\_modified\_on: optional string When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: optional string When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property

Link to this property

AAAARecord = AAAARecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

CNAMERecord = CNAMERecord { name, ttl, type, 5 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

MXRecord = MXRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

NSRecord = NSRecord { name, ttl, type, 5 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

OpenpgpkeyRecord object {id, comment, content, 12 more }

id: string Identifier. maxLength32 Link to this property comment: string Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property content: string A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property modified\_on: string When the record was last modified. formatdate-time Link to this property name: string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property proxiable: boolean Whether the record can be proxied by Cloudflare or not. Link to this property proxied: boolean Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property

settings: object {ipv4\_only, ipv6\_only } Settings for the DNS record.

ipv4\_only: optional boolean When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property ipv6\_only: optional boolean When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property

Link to this property tags: array of RecordTags Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property

ttl: TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following: number Link to this property 1 Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property

Link to this property type: "OPENPGPKEY" Record type. Link to this property comment\_modified\_on: optional string When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: optional string When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property

Link to this property

PTRRecord = PTRRecord { name, ttl, type, 5 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

TXTRecord = TXTRecord { name, ttl, type, 5 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

CAARecord = CAARecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

CERTRecord = CERTRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

DNSKEYRecord = DNSKEYRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

DSRecord = DSRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

HTTPSRecord = HTTPSRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

LOCRecord = LOCRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

NAPTRRecord = NAPTRRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

SMIMEARecord = SMIMEARecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

SRVRecord = SRVRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

SSHFPRecord = SSHFPRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

SVCBRecord = SVCBRecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

TLSARecord = TLSARecord { name, ttl, type, 6 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

URIRecord = URIRecord { name, ttl, type, 7 more }

id: string Identifier. maxLength32 Link to this property created\_on: string When the record was created. formatdate-time Link to this property

meta: object {dead\_glue, is\_glue, shadowed\_by, shadowed\_records\_count } Extra Cloudflare-specific metadata about the record.

Link to this property

[Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20scan_list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

result\_info: optional object {count, page, per\_page, 2 more }

count: optional number Total number of results for the requested service. Link to this property page: optional number Current page within paginated list of results. Link to this property per\_page: optional number Number of results per page of results. Link to this property total\_count: optional number Total results available without any search parameters. Link to this property total\_pages: optional number The number of total pages in the entire result set. Link to this property

[Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20scan_list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### List Scanned DNS Records HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/scan/review \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": { "dead_glue": true, "is_glue": true, "shadowed_by": [ "372e67954025e0ba6aaa6d586b9e0b59" ], "shadowed_records_count": 42 }, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": { "dead_glue": true, "is_glue": true, "shadowed_by": [ "372e67954025e0ba6aaa6d586b9e0b59" ], "shadowed_records_count": 42 }, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ```