Censys · Schema

Dns

Dns schema from Asset Graph API

SecurityInternet IntelligenceAttack Surface ManagementThreat HuntingCyber Threat IntelligenceOSINTInternet ScanningCertificatesAsset Discovery

Properties

Name Type Description
additionals arraynull A list of resource records (RRs) contained in the ADDITIONAL section of the response.
answers arraynull A list of resource records (RRs) contained in the ANSWER section of the response.
authorities arraynull A list of resource records (RRs) contained in the AUTHORITIES section of the response.
edns object
questions arraynull A list of resource records (RRs) contained in the QUESTION section of the response, which may echo the request that the server is responding to.
r_code string A enumerated field indicating the result of the request. The most common values are defined in RFC 1035.
resolves_correctly boolean Whether the server returns an IP address for ip.parrotdns.com that matches the authoritative server, which is controlled by Censys.
server_type string An enumerated value indicating the behavior of the server. An AUTHORITATIVE server fulfills requests for domain names it controls, which are not listed by the server. FORWARDING and RECURSIVE_RESOLVER
version string
View JSON Schema on GitHub

JSON Schema

asset-graph-dns-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/censys/refs/heads/main/json-schema/asset-graph-dns-schema.json",
  "title": "Dns",
  "description": "Dns schema from Asset Graph API",
  "type": "object",
  "properties": {
    "additionals": {
      "description": "A list of resource records (RRs) contained in the ADDITIONAL section of the response.",
      "items": {
        "$ref": "#/components/schemas/Dns_ResourceRecord"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "answers": {
      "description": "A list of resource records (RRs) contained in the ANSWER section of the response.",
      "items": {
        "$ref": "#/components/schemas/Dns_ResourceRecord"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "authorities": {
      "description": "A list of resource records (RRs) contained in the AUTHORITIES section of the response.",
      "items": {
        "$ref": "#/components/schemas/Dns_ResourceRecord"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "edns": {
      "$ref": "#/components/schemas/Dns_EDns"
    },
    "questions": {
      "description": "A list of resource records (RRs) contained in the QUESTION section of the response, which may echo the request that the server is responding to.",
      "items": {
        "$ref": "#/components/schemas/Dns_ResourceRecord"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "r_code": {
      "description": "A enumerated field indicating the result of the request. The most common values are defined in RFC 1035.",
      "enum": [
        "",
        "success",
        "format_error",
        "server_failure",
        "name_error",
        "not_implemented",
        "refused",
        "yx_domain",
        "yx_rrset",
        "nx_rrset",
        "not_auth",
        "not_zone",
        "bad_sig",
        "bad_key",
        "bad_time",
        "bad_mode",
        "bad_name",
        "bad_alg",
        "bad_trunc",
        "bad_cookie"
      ],
      "type": "string"
    },
    "resolves_correctly": {
      "description": "Whether the server returns an IP address for ip.parrotdns.com that matches the authoritative server, which is controlled by Censys.",
      "type": "boolean"
    },
    "server_type": {
      "description": "An enumerated value indicating the behavior of the server. An AUTHORITATIVE server fulfills requests for domain names it controls, which are not listed by the server. FORWARDING and RECURSIVE_RESOLVER servers fulfill requests indirectly for domain names they do not control. A RECURSIVE_RESOLVER will query ip.parrotdns.com itself, resulting in its own IP address being present in the dns.answers.response field.",
      "enum": [
        "",
        "recursive_resolver",
        "authoritative",
        "forwarding",
        "redirecting"
      ],
      "type": "string"
    },
    "version": {
      "type": "string"
    }
  },
  "additionalProperties": false
}