Docs

API reference · DNS

List the records of a zone, oldest first

GET/v1/orgs/{org}/zones/{zone}/dns/records
Permission
dns.records.read
Operation
dns.records.list

Parameters

NameInTypeRequiredNotes
orgpathstringyesfor example "org_01h455vb4pex5vsknk084sn02q"
zonepathstringyesfor example "zone_01h455vb4pex5vsknk084sn02q"
limitqueryintegerno1 to 100; default 50
cursorquerystringno0 to 200 characters
namequerystringno0 to 255 characters
typequerystringnoone of "A", "AAAA", "CNAME", "NS", "MX", "TXT", "SRV", "CAA"
x-obhut-management-assignmentheaderstringnoSelect one staff assignment. Direct membership remains the default. Bound API tokens use their stored source and ignore this selector. For example "masg_01h455vb4pex5vsknk084sn02q"

Response 200

FieldTypeRequiredNotes
itemsarray of objectyes
items[].idstringyesfor example "record_01h455vb4pex5vsknk084sn02q"
items[].zoneIdstringyesfor example "zone_01h455vb4pex5vsknk084sn02q"
items[].namestringyes
items[].ttlintegeryes60 to 86400
items[].dataobject or object or object or object or object or object or object or objectyes
items[].data.type"A"yes
items[].data.addressstring (ipv4)yes
items[].data.targetstringyes1 to 253 characters
items[].data.nameserverstringyes1 to 253 characters
items[].data.priorityintegeryes0 to 65535
items[].data.exchangestringyes1 to 253 characters
items[].data.textstringyes1 to 4096 characters
items[].data.weightintegeryes0 to 65535
items[].data.portintegeryes0 to 65535
items[].data.flagsintegeryes0 to 255
items[].data.tagstringyesone of "issue", "issuewild", "iodef"
items[].data.valuestringyes1 to 1024 characters
items[].revisionstringyesOpaque revision: dot-joined counters.
items[].createdAtstring (date-time)yesUTC, ISO 8601.
items[].updatedAtstring (date-time)yesUTC, ISO 8601.
nextCursorstring or nullyes