Output format | Documentation | Reverse DNS API | WhoisXML API

Output format

{
    "result": [
        {
            "value": "ns1.google.com. dns-admin.google.com. 658337085 900 900 1800 60",
            "wildcard": null,
            "active": true,
            "name": "1bgo9ev2in.com",
            "first_seen": 1697553732,
            "last_visit": 1728317192
        },
        {
            "value": "ns1.google.com. dns-admin.google.com. 664077773 900 900 1800 60",
            "wildcard": null,
            "active": true,
            "name": "1bgo9ev2in.com",
            "first_seen": 1697553732,
            "last_visit": 1728317192
        },
        {
            "value": "ns1.google.com. dns-admin.google.com. 668858537 900 900 1800 60",
            "wildcard": null,
            "active": true,
            "name": "1bgo9ev2in.com",
            "first_seen": 1697553732,
            "last_visit": 1728317192
        },
        {
            "value": "ns1.google.com. dns-admin.google.com. 682618118 900 900 1800 60",
            "wildcard": null,
            "active": true,
            "name": "1bgo9ev2in.com",
            "first_seen": 1697553732,
            "last_visit": 1728317192
        },
        {
            "value": "ns1.google.com. dns-admin.google.com. 682852035 900 900 1800 60",
            "wildcard": null,
            "active": true,
            "name": "1bgo9ev2in.com",
            "first_seen": 1697553732,
            "last_visit": 1728317192
        }
    ],
    "size": 5
}

Output parameters

result
Segment contains info about the resulting DNS record data.
result[0].name
Domain name
result[0].value
DNS record value
result[0].wildcard

If the includeAdditionalChecks=1 flag wasn't passed in the query, this field will be absent in the response.

The wildcard field indicates whether the DNS record is part of a wildcard entry. To determine this:

  • We replace the last domain level with a random string, creating a new Fully Qualified Domain Name (FQDN) as a subdomain.
  • We then query the nameserver for this newly generated FQDN.
  • If the nameserver returns a DNS record for this random subdomain, the original domain is marked as a wildcard entry.

If the field is true, it means:

  • The domain has a wildcard DNS configuration (e.g., *.example.com).
  • Any subdomain of the form sub.example.com will resolve to a valid DNS record, as the wildcard (*) catches all subdomains not explicitly defined.

If the field is false, it means:

  • Only explicitly defined subdomains will have corresponding DNS records.
  • A query for a random subdomain (e.g., sub.example.com) will not resolve to a valid DNS record unless it has been specifically configured.

If the field is empty (null), it means that we have not yet checked the DNS record for this domain.

Possible values: true | false | null

result[0].active

If the includeAdditionalChecks=1 flag wasn't passed in the query, this field will be absent in the response.

The active field shows whether a DNS record exists for the given domain. The check works as follows:

  • The FQDN is queried multiple times against the DNS server.
  • If a valid DNS record is returned, the domain is marked as active.
  • If the DNS server returns an error or no record is found during these queries, the domain is marked as not active.

If the field is true, it means:

  • The DNS record was successfully retrieved.
  • The domain's DNS resolution was successful.

If the field is false, it means:

  • The DNS record could not be retrieved.
  • The domain's DNS resolution was unsuccessful during our attempts.

If the field is empty (null), it means that we have not yet checked the DNS record for this domain.

Possible values: true | false | null

result[0].first_seen
Timestamp of the first time that the record was seen.
result[0].last_visit
Timestamp of the last update for this record.
size
Number of records in result segment.