Forward DNS Lookup

Queries DNS for a specified name and record type, and returns the responses.

GET
https://api.example.com/v1/dns/lookup

If successful, this endpoint will return a 200 OK status.

Arguments

The following arguments are supported for this endpoint.

Name Type Default Value

hostname Required

The hostname to query

String None

type Required

The requested record type

String None

trace

Run a full recursive lookup starting from the root nameservers and return only uncached data

Boolean false

Returned Object

When the request is successful, you can expect an object matching the specification below to be returned.

{
    results: [ DNS Response {
        server: String
        answers: [ DNS Answer {
            name: String
            ttl: Integer
            type: String
            value: String
        } ]
    } ]
}