> ## Documentation Index > Fetch the complete documentation index at: https://gcore.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List of RRset > List of RRset. ## OpenAPI ````yaml /api-reference/services_documented/dns_api.yaml get /dns/v2/zones/{zoneName}/rrsets openapi: 3.1.0 info: title: Gcore OpenAPI – DNS API description: >- This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS Protection, Object Storage, Streaming, and FastEdge services. version: '2026-05-15T06:37:28.230198+00:00' servers: - url: https://api.gcore.com security: - APIKey: [] tags: - name: Analyze x-displayName: Analyze - name: DNS Locations x-displayName: DNS Locations - name: Lookup x-displayName: Lookup - name: Metrics x-displayName: Metrics - name: NetworkMappings x-displayName: NetworkMappings - name: Pickers x-displayName: Pickers - name: DNS Clients x-displayName: DNS Clients - name: Zones x-displayName: Zones - name: DNSSEC x-displayName: DNSSEC - name: RRsets x-displayName: RRsets paths: /dns/v2/zones/{zoneName}/rrsets: get: tags: - RRsets summary: List of RRset description: List of RRset. operationId: RRSetList parameters: - name: offset in: query description: Amount of records to skip before beginning to write in response. schema: type: integer format: uint64 - name: limit in: query description: Max number of records in response schema: type: integer format: uint64 - name: order_by in: query description: Field name to sort by schema: type: string - name: order_direction in: query description: Ascending or descending order schema: type: string enum: - asc - desc - name: zoneName in: path required: true schema: type: string responses: '200': description: ListRRSetResponse content: application/json: schema: $ref: '#/components/schemas/ListRRSetResponse' '400': description: Error message response headers: error: schema: type: string content: {} x-codeSamples: - lang: Python source: |- import os from gcore import Gcore client = Gcore( api_key=os.environ.get("GCORE_API_KEY"), # This is the default and can be omitted ) rrsets = client.dns.zones.rrsets.list( zone_name="zoneName", ) print(rrsets.rrsets) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/G-Core/gcore-go\"\n\t\"github.com/G-Core/gcore-go/dns\"\n\t\"github.com/G-Core/gcore-go/option\"\n)\n\nfunc main() {\n\tclient := gcore.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\trrsets, err := client.DNS.Zones.Rrsets.List(\n\t\tcontext.TODO(),\n\t\t\"zoneName\",\n\t\tdns.ZoneRrsetListParams{},\n\t)\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", rrsets.Rrsets)\n}\n" components: schemas: ListRRSetResponse: type: object properties: rrsets: type: array items: $ref: '#/components/schemas/OutputRRSet' total_amount: type: integer format: int64 OutputRRSet: required: - name - resource_records - type type: object properties: filter_set_id: type: integer format: uint64 meta: type: object additionalProperties: type: object description: >- Meta information for rrset. Map with string key and any valid json as value, with valid keys 1. `failover` (object, beta feature, might be changed in the future) can have fields 1.1. `protocol` (string, required, HTTP, TCP, UDP, ICMP) 1.2. `port` (int, required, 1-65535) 1.3. `frequency` (int, required, in seconds 10-3600) 1.4. `timeout` (int, required, in seconds 1-10), 1.5. `method` (string, only for protocol=HTTP) 1.6. `command` (string, bytes to be sent only for protocol=TCP/UDP) 1.7. `url` (string, only for protocol=HTTP) 1.8. `tls` (bool, only for protocol=HTTP) 1.9. `regexp` (string regex to match, only for non-ICMP) 1.10. `http_status_code` (int, only for protocol=HTTP) 1.11. `host` (string, only for protocol=HTTP) 2. `geodns_link` (string) - name of the geodns link to use, if previously set, must re-send when updating or CDN integration will be removed for this RRSet example: {} name: type: string example: sub.example.com pickers: type: array description: Set of pickers items: $ref: '#/components/schemas/OutputFilter' resource_records: type: array description: List of resource record from rrset items: $ref: '#/components/schemas/OutputResourceRecord' ttl: type: integer format: uint32 type: type: string description: RRSet type enum: - A - AAAA - NS - CNAME - MX - TXT - SRV - SOA updated_at: $ref: '#/components/schemas/Timestamp' warning: type: string description: >- Warning about some possible side effects without strictly disallowing operations on rrset readonly Deprecated: use Warnings instead warnings: type: array description: >- Warning about some possible side effects without strictly disallowing operations on rrset readonly items: $ref: '#/components/schemas/Warning' OutputFilter: required: - type type: object properties: limit: type: integer description: >- Limits the number of records returned by the filter Can be a positive value for a specific limit. Use zero or leave it blank to indicate no limits. format: int64 strict: type: boolean description: >- if strict=false, then the filter will return all records if no records match the filter type: type: string description: Filter type enum: - geodns - asn - country - continent - region - ip - geodistance - weighted_shuffle - default - first_n OutputResourceRecord: required: - content type: object properties: content: type: array description: >- Content of resource record The exact length of the array depends on the type of rrset, each individual record parameter must be a separate element of the array. For example SRV-record: `[100, 1, 5061, "example.com"]` CNAME-record: `[ "the.target.domain" ]` A-record: `[ "1.2.3.4", "5.6.7.8" ]` AAAA-record: `[ "2001:db8::1", "2001:db8::2" ]` MX-record: `[ "mail1.example.com", "mail2.example.com" ]` SVCB/HTTPS-record: `[ 1, ".", ["alpn", "h3", "h2"], [ "port", 1443 ], [ "ipv4hint", "10.0.0.1" ], [ "ech", "AEn+DQBFKwAgACABWIHUGj4u+PIggYXcR5JF0gYk3dCRioBW8uJq9H4mKAAIAAEAAQABAANAEnB1YmxpYy50bHMtZWNoLmRldgAA" ] ]` example: - 100 - 1 - 5061 - example.com items: type: object enabled: type: boolean default: true id: type: integer format: uint64 example: 42 meta: type: object additionalProperties: type: object description: >- Meta information for record Map with string key and any valid json as value, with valid keys 1. `asn` (array of int) 2. `continents` (array of string) 3. `countries` (array of string) 4. `latlong` (array of float64, latitude and longitude) 5. `backup` (bool) 6. `notes` (string) 7. `weight` (float) 8. `ip` (string) 9. `default` (bool) Some keys are reserved for balancing, @see https://api.gcore.com/dns/v2/info/meta This meta will be used to decide which resource record should pass through filters from the filter set example: continents: - europe - asia countries: - us - gb - lu ip: - 192.168.15.150/25 - 2003:de:2016::/48 Timestamp: type: string description: Timestamp marshals/unmarshals date and time as timestamp in json format: date-time Warning: type: object properties: key: type: string message: type: string securitySchemes: APIKey: description: >- API key for authentication. Make sure to include the word `apikey`, followed by a single space and then your token. Example: `apikey 1234$abcdef` type: apiKey in: header name: Authorization ````