## List DNS Records `client.DNS.Records.List(ctx, params) (*V4PagePaginationArray[RecordResponse], error)` **get** `/zones/{zone_id}/dns_records` List, search, sort, and filter a zones' DNS records. ### Parameters - `params RecordListParams` - `ZoneID param.Field[string]` Path param: Identifier. - `Comment param.Field[RecordListParamsComment]` Query param - `Absent string` If this parameter is present, only records *without* a comment are returned. - `Contains string` Substring of the DNS record comment. Comment filters are case-insensitive. - `Endswith string` Suffix of the DNS record comment. Comment filters are case-insensitive. - `Exact string` Exact value of the DNS record comment. Comment filters are case-insensitive. - `Present string` If this parameter is present, only records *with* a comment are returned. - `Startswith string` Prefix of the DNS record comment. Comment filters are case-insensitive. - `Content param.Field[RecordListParamsContent]` Query param - `Contains string` Substring of the DNS record content. Content filters are case-insensitive. - `Endswith string` Suffix of the DNS record content. Content filters are case-insensitive. - `Exact string` Exact value of the DNS record content. Content filters are case-insensitive. - `Startswith string` Prefix of the DNS record content. Content filters are case-insensitive. - `Direction param.Field[SortDirection]` Query param: Direction to order DNS records in. - `IncludeShadowMetadata param.Field[bool]` Query param: Whether to include shadow metadata in the `meta` field of each record in the response. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `Match param.Field[RecordListParamsMatch]` Query param: Whether to match all search requirements or at least one (any). If set to `all`, acts like a logical AND between filters. If set to `any`, acts like a logical OR instead. Note that the interaction between tag filters is controlled by the `tag-match` parameter instead. - `const RecordListParamsMatchAny RecordListParamsMatch = "any"` - `const RecordListParamsMatchAll RecordListParamsMatch = "all"` - `Name param.Field[RecordListParamsName]` Query param - `Contains string` Substring of the DNS record name. Name filters are case-insensitive. - `Endswith string` Suffix of the DNS record name. Name filters are case-insensitive. - `Exact string` Exact value of the DNS record name. Name filters are case-insensitive. - `Startswith string` Prefix of the DNS record name. Name filters are case-insensitive. - `Order param.Field[RecordListParamsOrder]` Query param: Field to order DNS records by. - `const RecordListParamsOrderType RecordListParamsOrder = "type"` - `const RecordListParamsOrderName RecordListParamsOrder = "name"` - `const RecordListParamsOrderContent RecordListParamsOrder = "content"` - `const RecordListParamsOrderTTL RecordListParamsOrder = "ttl"` - `const RecordListParamsOrderProxied RecordListParamsOrder = "proxied"` - `Page param.Field[float64]` Query param: Page number of paginated results. - `PerPage param.Field[float64]` Query param: Number of DNS records per page. - `Proxied param.Field[bool]` Query param: Whether the record is receiving the performance and security benefits of Cloudflare. - `Search param.Field[string]` Query param: Allows searching in multiple properties of a DNS record simultaneously. This parameter is intended for human users, not automation. Its exact behavior is intentionally left unspecified and is subject to change in the future. This parameter works independently of the `match` setting. For automated searches, please use the other available parameters. - `ShadowedByName param.Field[string]` Query param: Filters to records at or below the given NS delegation name, excluding the NS records that form the delegation itself. The value must be a subdomain of the zone; the zone apex is not accepted. Requires `include_shadow_metadata=true`. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowingName param.Field[string]` Query param: Returns NS records that shadow the given name, searching at the name itself and each of its ancestor names within the zone, excluding the zone apex. The value must be a subdomain of the zone; the zone apex is not accepted. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `Tag param.Field[RecordListParamsTag]` Query param - `Absent string` Name of a tag which must *not* be present on the DNS record. Tag filters are case-insensitive. - `Contains string` A tag and value, of the form `:`. The API will only return DNS records that have a tag named `` whose value contains ``. Tag filters are case-insensitive. - `Endswith string` A tag and value, of the form `:`. The API will only return DNS records that have a tag named `` whose value ends with ``. Tag filters are case-insensitive. - `Exact string` A tag and value, of the form `:`. The API will only return DNS records that have a tag named `` whose value is ``. Tag filters are case-insensitive. - `Present string` Name of a tag which must be present on the DNS record. Tag filters are case-insensitive. - `Startswith string` A tag and value, of the form `:`. The API will only return DNS records that have a tag named `` whose value starts with ``. Tag filters are case-insensitive. - `TagMatch param.Field[RecordListParamsTagMatch]` Query param: Whether to match all tag search requirements or at least one (any). If set to `all`, acts like a logical AND between tag filters. If set to `any`, acts like a logical OR instead. Note that the regular `match` parameter is still used to combine the resulting condition with other filters that aren't related to tags. - `const RecordListParamsTagMatchAny RecordListParamsTagMatch = "any"` - `const RecordListParamsTagMatchAll RecordListParamsTagMatch = "all"` - `Type param.Field[RecordListParamsType]` Query param: Record type. - `const RecordListParamsTypeA RecordListParamsType = "A"` - `const RecordListParamsTypeAAAA RecordListParamsType = "AAAA"` - `const RecordListParamsTypeCAA RecordListParamsType = "CAA"` - `const RecordListParamsTypeCERT RecordListParamsType = "CERT"` - `const RecordListParamsTypeCNAME RecordListParamsType = "CNAME"` - `const RecordListParamsTypeDNSKEY RecordListParamsType = "DNSKEY"` - `const RecordListParamsTypeDS RecordListParamsType = "DS"` - `const RecordListParamsTypeHTTPS RecordListParamsType = "HTTPS"` - `const RecordListParamsTypeLOC RecordListParamsType = "LOC"` - `const RecordListParamsTypeMX RecordListParamsType = "MX"` - `const RecordListParamsTypeNAPTR RecordListParamsType = "NAPTR"` - `const RecordListParamsTypeNS RecordListParamsType = "NS"` - `const RecordListParamsTypeOpenpgpkey RecordListParamsType = "OPENPGPKEY"` - `const RecordListParamsTypePTR RecordListParamsType = "PTR"` - `const RecordListParamsTypeSMIMEA RecordListParamsType = "SMIMEA"` - `const RecordListParamsTypeSRV RecordListParamsType = "SRV"` - `const RecordListParamsTypeSSHFP RecordListParamsType = "SSHFP"` - `const RecordListParamsTypeSVCB RecordListParamsType = "SVCB"` - `const RecordListParamsTypeTLSA RecordListParamsType = "TLSA"` - `const RecordListParamsTypeTXT RecordListParamsType = "TXT"` - `const RecordListParamsTypeURI RecordListParamsType = "URI"` ### Returns - `type RecordResponse interface{…}` - `type RecordResponseARecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseARecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseAAAARecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseAAAARecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseCNAMERecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseCNAMERecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseMXRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseMXRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseNSRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseNSRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseOpenpgpkeyRecord struct{…}` - `ID string` Identifier. - `Comment string` Comments or notes about the DNS record. This field has no effect on DNS responses. - `Content string` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `CreatedOn Time` When the record was created. - `Meta RecordResponseOpenpgpkeyRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Name string` Complete DNS record name, including the zone name, in Punycode. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `Proxied bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `Settings RecordResponseOpenpgpkeyRecordSettings` Settings for the DNS record. - `IPV4Only bool` 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. - `IPV6Only bool` 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. - `Tags []RecordTags` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float64` - `type TTL float64` 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. - `const TTL1 TTL = 1` - `Type RecordResponseOpenpgpkeyRecordType` Record type. - `const RecordResponseOpenpgpkeyRecordTypeOpenpgpkey RecordResponseOpenpgpkeyRecordType = "OPENPGPKEY"` - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponsePTRRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponsePTRRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseTXTRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseTXTRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseCAARecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseCAARecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseCERTRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseCERTRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseDNSKEYRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseDNSKEYRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseDSRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseDSRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseHTTPSRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseHTTPSRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseLOCRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseLOCRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseNAPTRRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseNAPTRRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseSMIMEARecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseSMIMEARecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseSRVRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseSRVRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseSSHFPRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseSSHFPRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseSVCBRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseSVCBRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseTLSARecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseTLSARecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. - `type RecordResponseURIRecord struct{…}` - `ID string` Identifier. - `CreatedOn Time` When the record was created. - `Meta RecordResponseURIRecordMeta` Extra Cloudflare-specific metadata about the record. - `DeadGlue bool` 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](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#unreachable-glue-records). - `IsGlue bool` Whether this A or AAAA record is glue for a subdomain NS delegation. See [Glue records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records#glue-records). - `ShadowedBy []string` IDs of the NS records that shadow this record. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ShadowedRecordsCount int64` Number of records shadowed by this NS delegation. See [Shadowed records](https://edgetunnel-b2h.pages.dev/dns/manage-dns-records/reference/shadowed-records). - `ModifiedOn Time` When the record was last modified. - `Proxiable bool` Whether the record can be proxied by Cloudflare or not. - `CommentModifiedOn Time` When the record comment was last modified. Omitted if there is no comment. - `TagsModifiedOn Time` When the record tags were last modified. Omitted if there are no tags. ### Example ```go package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/dns" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.DNS.Records.List(context.TODO(), dns.RecordListParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` #### Response ```json { "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 } } ```